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By Eric Gundrum 








THE Past 

By the time you read this, you probably are just about to or 
already have stuffed yourself with turkey (or a reasonable 
vegetarian alternative) and are preparing for the holiday season. 
The new year is just around the corner and with it. the 
opportunity for change. 

MacTech has recently undergone some changes, and one 
of the results is my beginning as Editor-in-Chief. In the last 
several months, many people at MacTech have made a number 
of beneficial changes in how we build the magazine, making 
my job a whole lot easier. We now have Jessica Courtney as our 
Managing Editor, and Nick DeMello for online support. In 
addition, we’ve broadened our Editorial Board to include Carl 
de Cordova for Internet Technologies, and Will Iverson 
(formerly of MacTech and Symantec, and now at Apple) for 
Java. Today, MacTech editorial is created by more people than 
ever before in the magazine’s almost 13-year history. 

My name has been on the MacTech masthead for some 
time now. I’ve been working in the background, helping 
where I could. Some of you may also know me from my 
work at MacHack. Others may recognize me from my 
SmartFriends affiliations, and others might remember me 
from my days working on MicroPhone at the now defunct 
Software Ventures. I am a professional programmer. I’ve been 
working in the Macintosh industry for seven years now; 
wow, has it changed. 


THE FUTURE 

For as long as there have been personal computers I have 
enjoyed programming them. I still have a bookshelf full of 
MacTutor (the old name for MacTech), complete with the 
Table of Contents on the cover. Since that time the magazine 
has served Mac OS programmers, professional and hobbyist 
alike. Nonetheless, our industry has grown up a bit, and 
MacTech with it. (Now we put the Table of Contents inside 
like other magazines.) 

Since taking this position, I’ve spoken with many 
colleagues about what changes they want to see in the 
magazine. Their responses were just as varied as the people I 
asked. Some want more in-depth, technical articles, and some 
want more about getting started with programming. Many 
people asked for more articles in the middle — articles that 
provide a bridge from starting out as a programmer, to the more 
sophisticated problems of deciphering the runtime model of a 
fat SCSI driver used for disk compression. I plan to satisfy all of 
these requests in the coming months, but most of all, I want to 
increase the quality of the articles. 


4 VIEWPOINT 





We have many exciting issues planned for the next year. 
From a look at the BeOS to new views of programming 
Macintosh without C++. We’ve got “goodies” coming your way 
— for example, the DR8 release of the BeOS for Power 
Macintosh will be included on CD in the January issue. For the 
C++ geeks, we will offer a number of ideas for getting more 
from the beast before it gets you. You can expect to see more 
reviews of programming tools to let you know what gets the 
job done. There will also be some code showing you how to 
get the job done. We will continue to bring you articles 
demonstrating tricks of the trade, and of course, we will bring 
you some more code. As the Mac moves forward with new 
technologies, we will show you the code that lets you use those 
technologies now. If we can find other interesting things to do 
with code, we will show you that too. 

As you can see, we are planning to show you the code. 
Nothing documents a program as well as well written code. You 
can rest assured that there will be plenty of articles to inform 
and entertain you. There may not be any more pages of code 
than before, but we will give you the snippets that count; the 
ones you will continue to refer back to. You can expect more 
cool programming projects, and more cool technologies, and, of 
course, more cool code. 

We want to show you interesting things people are 
programming the Mac to do, and give you ideas about what 
you can do. Do you have an idea you want to share? Drop a 
note to editorial@mactech.com. Want to get up on your soapbox, 
write us at letters@mactech.com. And, if you want share a tidbit, 
send a tip to tips@mactech.com. 


THE PRESENT 

In this issue you will want to check out our comprehensive 
review of the CodeWarrior and Symantec development 
environments. Both tools have their strengths and their 
weaknesses. Read the article to choose which is best for you. 

Ed Ringel offers a low cost approach to meeting the 
information management needs of your latest project. If you 
want a quick and easy way to store a lot of data, be sure to 
read “A Tightwad’s Guide to Flat File Databases.” 

In another feature article, Andy Dent shows how to modify 
AppMaker 2.0 to generate code for custom objects in 
“Customizing AppMaker 2.0.” This is a must-read for everyone 
looking for faster ways to build graphical interfaces. Best of all, 
AppMaker writes the C++ so you don’t have to. 

Furthermore, the magazine would not be complete without 
the interesting items from our regular contributors. Flip through 
the pages to find all that is there. Wau 
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Each year, the illegal use of software consumes 
nearly 50% of your potential revenues. With the 
flames of piracy eating away at your profits, can 
you afford not to protect your software? 


Software Developers: 


Software Piracy 
Burns Your 


Software Obtained Illegally, by region, 1993 vs. 1994 
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MacHASP® is widely acclaimed as the world’s 
most advanced software protection solution for 
Mac and Power Mac computers. Since 1984, 
thousands of leading Mac and PC developers have 
used over two million MacHASP and HASP keys 
to protect billions of dollars worth of software. 
Why? Because MacHASP’s security, reliability, and 
ease-of-use led them to a simple conclusion: 
MacHASP is the most effective software protection 
system available. 








Today, more software developers are choosing 
MacHASP than any other software protection 
method. To learn why, and to see how easily you 
can increase your revenues, call today to order 
your low-cost MacHASP Developer’s Kit. 


1-800-223-4277 
www.aks.com 





The Professional’s Choice 
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Java Events 





JAVA EVENTS 





Originally I was planning to cover 
double-buffering in this month’s column. I 
started writing a cool banner animator, 
then I got a little side-tracked playing with 
Java’s event-handling mechanism. As I 
explored (and as my animation applet took 
on a life of its own!), I realized that we 
never really covered events. Since events 
are the heart and soul of your applet’s user 
interaction, and since I ended up writing 
this nifty little event doodad anyway, I 
thought we would dive into events now 
and put off animation for the moment. 


THE ULTIMATE EVENT HANDLER 


This month’s applet is called 
eventHandler. For you Primer readers, 
eventHandler is similar to eventTracker. As 
you click, drag, and type, the events 
associated with those actions are displayed 
in a scrolling list. Figure 1 shows 
eventHandler running in the Metrowerks 
Java applet viewer. One thing I learned 
from this exercise is that no two applet 
viewers behave exactly the same way. For 
example, the Metrowerks Java viewer 
swallows keyUp events. In Netscape Gold 
3.0 (see Figure 2), the keyUp events show 
up, but mouseMove events are not 
reported properly. The Sun JDK Applet 
Viewer 1.0.2 (not shown) doesn’t handle 
clipping correctly. <sigh>. Well, at least 
these applet viewers are much better than 
their predecessors! 





Figure 1. eventHandler running in Metrowerks’ Applet Viewer. 
Notice that keyUp events are swallowed. See Figure 2. 


_ 





Figure 2. eventHandler running in Netscape Gold 3.0. The keyUp 
events are there, but mouseMove events (not shown) don’t work right. 
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tgttulavareye Mm Obeid. 
Bounds Checker on Windows 


Now, from. the makers of QC, comes... 


Find Bugs Fast 

Spotlight is the first Automatic Memory Debugger for the 
Macintosh. Instantly detect invalid memory accesses, bad 
toolbox parameters, leaks, stack overwrites, memory reloca- 
tion problems, and much more. 

Spotlight uses your XSYM file to automatically patch your 
application — no need to change your source code. No need 
to recompile. No learning curve whatsoever. 

The interface gives you instant feedback when an error is 
detected. You can ignore the error, ignore all future occurrences 
of the error, or log the error to a text file for later analysis. 


Fine Grained Memory Protection 

Spotlight identifies reads and writes outside of the applica- 
tion and system heap. But it does not stop there. Spotlight’s 
Object Code Replacement instrumentation inspects each read 
and write instruction in your code, detecting faulty memory 
reads and writes that occur between blocks, in released blocks, 
across multiple blocks, and in ROM. 

This technology works on any heap object you can allo- 
cate: Mac heap objects, C ‘malloc’ heap objects, even C++ 
objects created with new. 

Spotlight stops your application whenever a faulty memory 
access is about to occur and displays the exact source code 
line where it will happen. The calling stack is shown along 
with a display of all variables. A memory viewer shows the 


erroneous memory address and contents. 


Toolbox Validation 

Spotlight checks parameters to over 400 toolbox API calls, 
automatically validating handles, memory blocks, return val- 
ues, and so on. Specific checks catch subtle errors such as draw- 


ing into an unlocked GWorld, passing an invalid window 


OSM erarsicersel 





pointer, passing an address within an unlocked handle to a 


routine that may move memory, and too many more to list. 


Leak Detection 

No more struggling with MacsBug. On program exit Spot- 
light provides a clear listing of all leaked memory showing a 
full stack trace from where the memory was allocated. Instantly 
discover all leaked Mac OS objects, malloc’d objects, 
C++ objects, and resources. 


Limitations 

Spotlight requires an XSYM file to function. MPW and 
CodeWarrior users can generate these directly. Symantec us- 
ers must use ToolServer to link with an XSYM capable linker. 
Spotlight requires a PowerPC processor. 

Spotlight works on the object code. No source code is re- 
quired: just the thing for testing purchased third party libraries. 


Availability and Pricing 

Pricing for Spotlight DR1 is $199 US (plus $5 shipping and 
handling within the continental US, $15 for international 
orders). This includes a free upgrade to the GM version and 
access to ftp interim upgrades leading up to GM. QC users can 
cross-grade to Spotlight for only $149. 


All Onyx products carry a 30 day no questions asked money 


back guarantee. 


Onyx Technology, Inc. 
7811 27th Avenue West 
Bradenton, Florida 34209 





www.onyx-tech.com 


941 795-5901 (fax) 


sales@onyx-tech.com 


941 795-7801 





Spotlight and QC are trademarks of Onyx Technology, Inc. All other trademarks are property of their respective owners. 


eventHandler consists of two major areas (each with its 
own label). On the top is a Canvas with a yellow background. 
All the events trapped by this Canvas are listed in the scrolling 
TextArea on the bottom. When the keyboard focus is on the 
Canvas, its border is drawn in red. When the Canvas loses the 
keyboard focus, the border is redrawn as yellow. 

If you click or drag in the Canvas, the appropriate events 
get listed in the scrolling list. If you type while the focus is in 
the Canvas, the actual key names are listed when the keyDown 
event is reported. Note that I don’t report the mouseMove 
event, which is supposed to occur when you move the mouse. 
Unfortunately, the Metrowerks viewer is the only one that 
handles this correctly. Both Netscape and the Sun viewer report 
a steady stream of mouseMove events, even when the mouse is 
perfectly still! This can be a real pain, since any other events 
tend to get swept away in a flood of incorrectly reported 
mouseMove events. Add a mouseMove handler to the code 
below, just to see this for yourself. 


THE EVENTHANDLER SOURCE CODE 


Create a new project using the Java Applet stationery. 
Create a source code file named eventHandler.java and add it to 
the project. Here’s the source code: 


import java.awt.*; 


public class eventCanvas extends Canvas 

| boolean hasFocus; 

eventCanvas( int width, int height ) 

| setBackground( Color.yellow ); 
resize( width, height ); 


hasFocus = false: 


} 


public boolean mouseUp( Event e, int x, int y ) 
{ 
eventHandler.reportEvent( “mouseUp” ); 
return true; 


} 


public boolean mouseDown( Event e, int x, int y ) 
{ 
eventHandler.reportEvent( “mouseDown” ); 
return true; 


public boolean mouseDrag( Event e, int x, int y ) 
{ 
eventHandler.reportEvent( “mouseDrag” ); 
return true; 


} 


public boolean mouseEnter( Event e, int x, int y ) 
{ 
eventHandler.reportEvent( “mouseEnter” ); 
return true; 


} 


public boolean mouseExit( Event e, int x, int y ) 
{ 
eventHandler.reportEvent( “mouseExit” ); 
return true; 


} 


JAVA EVENTS 


public boolean 


{ 


keyDown( Event e, int key ) 


String eventString = “keyDown: “; 
String keyName, modifierName; 


modifierName 


= getModifierName( e ); 


if ( modifierName != null ) 
eventString t= modifierName; 


keyName = getKeyName( key ); 


if ( keyName 


!= null ) 


eventString t= keyName; 
else if (( key >= 32 ) && ( key <= 127 )) 
eventString t= new Character( (char)key ).toString(); 


else 


eventString += key; 


eventHandler 


return true; 


} 


.reportEvent( eventString ); 


public String getModifierName( Event e ) 


{ 


if ( e.controlDown() ) 
return( “Control-” ); 

if ( e.metaDown() ) 
return( “Meta-” ); 

if ( e.shiftDown() ) 
return( “Shift-” ); 


return null; 


} 


public String getKeyName( int key ) 


{ 
switch ( key 
{ 
case Event 
case Event 
case Event 


case Event 
case Event 
case Event 
case Event 


case Event 
case Event 
case Event 
case Event 
case Event 
case Event 
case Event 


fetirn nul: 


} 


public boolean 
{ 


eventHandler 


return true; 


} 


public boolean 


Fl? return “F1"; 
.F2: return “F2”; 
.F3: return “F3”; 
case Event. 
case Event. 
case Event. 
case Event. 
.F8: return “F8”; 
.F9: return “F9”; 
.F10: return “F110”; 
Elle return “F111: 
case Event. 
.HOME: return “HOME”; 

.END: return “END”; 

»LEFT:; return “Left Arrow”; 
RIGHT: return “Right Arrow”; 
.UP: return “Up Arrow”; 
.DOWN: return “DownArrow”; 
.PGUP: return “Page Up”; 

case Event. 


F4: return “F4”; 
F5: return “F5”; 
FO? return. “F6"s 
Hf: return “F/”: 


Fil2> return “F12”: 


PGDN: return “Page Down”; 


keyUp( Event e, int key ) 


.reportEvent( “keyUp” ); 


gotFocus(Event e, Object what) 


hasFocus = true; 


eventHandler. 


repaint (); 


return true; 


reportEvent( “gotFocus” ); 
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public boolean lostFocus(Event e, Object what) 
{ 


hasFocus = false; 
eventHandler.reportEvent( “lostFocus” ); 
repaint (); 


return true; 


} 
public void paint( Graphics g ) 
{ 


Rectangle rf; 


Cr 


bounds () ; 
getGraphics(); 


if ( hasFocus ) 

g.setColor( Color.red ); 
else 

g.setColor( Color.yellow ); 


r.height-1 ); 


g.drawRect( 0, 0, r.width-1, 
1 r. height-3 ); 


g.drawRect( 1, 1, r.width-3, 
} 
} 


public class eventHandler extends java.applet.Applet 
( 
eventCanvas 
static TextArea 


eCanvas; 
tArea; 


public void init() 
( 


add( new Label( “Click and type in this Canvas:” ) ); 


eCanvas = new eventCanvas( 200, 100 ); 
add( eCanvas ): 


add( new Label( “Here’s a list of canvas events:” ) ); 


tArea = new TextArea( 10, 30 ); 
add( tArea ); 
} 


public static void reportEvent( String eventString ) 
{ 
tArea.appendText( eventString + “\r” ); 
} 


Now create a file named eventHandler.html and add it to 
the project as well. Here’s the HTML: 


<title>Event Handler</title> 

<n? 

<applet codebase="eventHandler Classes” 
code=”"eventHandler.class” width=290 height=320> 
</applet> 

<hr> 

<a href="eventHandler.java”>»The source.</a> 


Now go into the Project Settings dialog (Under CW10, 
select Project Settings... from the Edit menu. See Figure 3. 
Earlier versions, Preferences from the Edit menu) and click on 
Project/Java Project. Select Class Folder from the Project Type 
popup and type “eventHandler Classes” as the File Name. Note 
that we’re no longer using non-ASCII characters (like f) in our 
Java-specific file and folder names. Though some environments 
can deal with these special characters, other environments, like 
Netscape, don’t recognize them and won’t be able to locate 
your class files. 
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Q: What does it take to deploy a 


superior client/server application? 
A: A SUPERIOR SERVER 


START with the 
most advanced client- 
side SDK on the 
market: c-tree® Plus 
at $895. 


¢ Complete “C” Source code 

® ROYALTY FREE 
(Client Side) 

¢ Multiple supported 
protocols 

¢ Fast, portable, reliable 

¢ Powerful features like 
transaction processing 

e Win95, NT, and 
Windows 3.1 ready 


ADD a strong, 


multi-platform, 

industrial-strength 

Server that supports. 

e File mirroring 

e Heterogeneous networking 

e Automatic disaster recovery 

e Multi-threaded design 

¢ Best price/performance 
available: from $445- $3745 


RESULT? 


A solid, economical, 
easily deployable 
product that fits 
your needs. 

e Portable 

¢ Scalable 

e Exceptional Performance 
e Flexible 

e Easy Server distribution 
¢ Convenient OEM terms 


FAIRCON?® 
Server 


Heterogeneous 
TCP/IP Network 


You can’t find a better client SDK with these features! 
Over sixteen years of proven reliability and performance. 
No one else supports over 30 platforms in this price range! 


c-tree Plus® 

¢ Complete C Source 

e Single/Multi User 

¢ Client/Server (optional) 

e Full ISAM functionality 

¢ No Royalties 

e Transaction Processing 

e Fixed/Variable Length Records 

e High Speed Data/Index 
Caching 

¢ Batch Operations 

e File Mirroring 

e¢ Multiple Contexts 

¢ Unsurpassed Portability 


FairCom® Server 
¢ Client/Server Model 
e Transaction Processing 
e Requires <2MB RAM 
¢ Online Backup 
e Disaster Recovery 
e Rollback - Forward 
e Anti-Deadlock 
Resolution 
¢ Client-side "C" Source 
¢ Multi-threading 
¢ Heterogeneous networking 
e File Mirroring 
¢ OEM/Source Available 


FOR YOUR NEXT PROJECT CALL FAIRCOM: YOU 
CAN'T FIND A BETTER HETEROGENEOUS 
CLIENT/SERVER SOLUTION! 


Also inquire about these FairCom products: 


FAIRCOM 


d-tree™ 
r-tree® 
ODBC Driver 


CORPORATION 


Since 1979 


\WWWeb Address: http://www. faircom.com/ 
So0oo0-234-818s80 


U.S.A. phone (573) 445-6833 fax (573) 445-9698 


(035) 773-464 fax (035 773-8 
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Figure 3. The CW10 Project Settings dialog. 





A terrific feature introduced with CW10 (there are a bunch 
of them) is the Set... button in the Project Settings dialog, which 
lets you select the application to which your html will be sent 
when you select Run from the Project menu. So if you like, you 
can use Netscape to test your applet or, if you prefer, use the 
applet viewer that ships with the JDK or with CW10. No matter 
which applet viewer you choose, be aware of any class caching 
schemes used by the viewer. If the viewer caches your class, it 
won't replace the class each time you run with a new version 
unless you quit the viewer each time you run. As I write this, I 
don’t know of any work-arounds for this. On the other hand, by 
the time you read this, maybe this won’t be an issue anymore. 


RUNNING EVENTHANDLER 

Once your source is entered, build your .class file and 
drop your html file on your favorite viewer. If you are using 
CodeWarrior, select Run from the Project menu. Once vour 
applet appears, generate some events. Try dragging the mouse 
within the Canvas to generate a stream of mouseDrag events. 
Click on the Canvas to generate a gotFocus event, then click 
outside the Canvas to lose the focus. Click on the Canvas to 
regain the focus, then bring the Finder to the front. Notice that 
the focus is lost, then regained when you bring the applet 
viewer to the front. 

Experiment! 


THE EVENTHANDLER SOURCE CODE 
eventHandler is broken into two classes. The eventCanvas 

class implements the yellow canvas area, adding to it the 
various event handlers. The hasFocus variable is a boolean that 
specifies whether the Canvas currently has the keyboard focus. 
The constructor takes a width and height, sets the background 
color to yellow, resizes the Canvas, and sets the focus to false. 
import java.awt.*; 
public class eventCanvas extends Canvas 

boolean 


hasFocus: 


eventCanvas( int width, int height ) 


10 JAVA EVENTS 


setBackground( Color.yellow ); 
resize( width, height ); 


hasFocus = false; 


Each of the event handlers overrides a default Canvas event 
handler. Each one reports its event by calling the static 
eventHandler function reportEvent(). We will get to that when 
we explore the eventHandler class in a bit. Each handler returns 
true, signifying that it has dealt with the event. mouseUp() and 
mouseDown() are called when the mouse button is pressed or 
released within the eventCanvas component. 


public boolean mouseUp( Event e, int x, int y ) 
{ 
eventHandler.reportEvent( “mouseUp” ); 
return true; 


public boolean mouseDown( Event e, int x, int y ) 
{ 
eventHandler.reportEvent( “mouseDown” ): 
return true; 


} 


mouseDrag() is called when the mouse is dragged within 
the eventCanvas, and mouseEnter() and mouseExit() are called 
when the mouse enters or leaves the eventCanvas boundaries. 


public boolean mouseDrag( Event e, int x, int y ) 


eventHandler.reportEvent( “mouseDrag” ); 
return true; 


} 


public boolean mouseEnter( Event e, int x, int y ) 
{ 
eventHandler.reportEvent( “mouseEnter” ): 
return true; 


} 
public boolean mouseExit( Event e, int x, int y ) 


eventHandler.reportEvent( “mouseExit” ); 
return true; 


keyDown() is called when a key is pressed, ONLY IF the 
eventCanvas has the focus. The keyDown() code basically builds 
a string reflecting the name of the key that was pressed. 
getModifierName() checks to see if the control, meta, or shift 
keys were down and, if so, adds the appropriate modifier name 
to the string. getkeyName() does a lookup on some standard 
Java key names. This table should be larger, but these are the 
only keynames I could find in the documentation. For example, 
I couldn’t find a TAB constant. 

If the key was an ASCII between 32 and 127, the 
character name is used, otherwise the key number is used. 
keyDown() is very simple-minded. After you experiment with it 
a bit, you might want to add more complexity to it to handle 
the other key types. 
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public boolean keyDown( Event e, int key ) case Event.Fl: return “F1”; 
{ case Event.F2: return “F2”; 
String eventString = “keyDown: “; case Event.F3: return “F3”; 
String keyName, modifierName; case Event.F4: return “F4”; 
case Event.F5: return “F5”; 
modifierName = getModifierName( e ); case Event.F6: return “F6”; 
if ( modifierName != null ) case Event.F7: return “F7”; 
eventString += modifierName; case Event.F8: return “F8”; 
case Event.F9: return “F9”; 
keyName = getKeyName( key ); case Event.Fl0: return “F10” 
case Event.Fll: return “F11” 
if ( keyName != null ) case Event.F1l2: return “P12”. 
eventString t= keyName; case Event.HOME: return “HOME” ; 
else if (( key >= 32 ) && ( key <= 127 )) case Event.END: return “END”; 
eventString t= new Character( (char)key ).toString(); case Event.LEFT: return “Left Arrow”; 
else case Event.RIGHT: return “Right Arrow”; 
eventString t= key; case Event.UP: return “Up Arrow”; 
case Event.DOWN: return “DownArrow”; 
eventHandler.reportEvent( eventString ); case Event.PGUP: return “Page Up”; 
case Event.PGDN: return “Page Down”; 








return true; } 
} 
return null; 
public String getModifierName( Event e ) 
{ 


if ( e.controlDown() ) public boolean keyUp( Event e, int key ) 
return( “Control-” ); { 

if ( e.metaDown() ) eventHandler.reportEvent( “keyUp” ); 
return( “Meta-” ); 

if ( e.shiftDown() ) return true; 


return( “Shift-" ); } 


return null; 


gotFocus() sets hasFocus to true, reports the event, and forces 
ene String getKeyName( int key ) a redraw. lostFocus() sets hasFocus to false and does the same. 


switch ( key ) 
{ 
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The reason we call Stufflt 
InstallerMaker 3.1 the Complete _ 
‘ie ol oo 


a 120 | Installation Solution is because 
we include everything you need to prepare a professional 
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TALL 5 | package of files for installation on your user’s machines. An installer, 


MI ; updater, and an uninstaller are just three components included 
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for the same price one of our fine competitors charges for Just 
the installer. Using our installer reduces technical support 
calls due to end-user errors during installation, saves disks 
(if distributing on floppies) or download time (if distributing 
on-line). You will save more than the cost of the Installer license by 
significantly reducing distribution costs. And the puzzle will be solved. 
You'll have every piece in place. 
Download a ree, fully-functional copy of 
Stufflt InstallerMaker 3.1 from www.aladdinsys.com 
or call (408) 761-6200 and ask for Developer Sales. 


EINSTALLERMAKER 3.1 


© 1996 Aladdin Systems, Inc. 165 Westridge Drive, Watsonville, CA 95076. Fax: (408) 761-6206. Internet: dev.sales@aladdinsys.com. 
AOL, AopkeLink: ALADDIN. Stufflt InstallerMaker is a trademark of Aladdin Systems, Inc. Other products are trademarks of their respective holders. 
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public boolean gotFocus(Event e, Object what) 
{ 


hasFocus = true; 
eventHandler.reportEvent( “gotFocus” ); 
repaint(); 


return true; 


public boolean lostFocus(Event e, Object what) 
{ 
hasFocus = false; 
eventHandler.reportEvent( “lostFocus” ); 
repaint(); 


Fecurh true. 


paint() sets the drawing color to red if the eventCanvas has 
the focus (yellow otherwise), then draws the bordering rectangle 
based on the bounding rectangle of the eventCanvas. Another 
peculiarity I ran into was trying to draw a pair of rectangles, one 
inside the other. I expected to use r.width-2 and r.height-2 as 
parameters to the second drawRect call. Somehow this cidn’t 
produce the results I expected. I tried this with all the viewers, 
and got different results with each one. I’m guessing that this is a 
flaw in the viewer implementation, though of course that 
assumption is pretty dangerous! If anyone sees a bug in this 
code, let me know <dmark@aol.com>. 
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public void paint( Graphics g ) 


Rectangle fr; 


bounds();: 
g 


r= 
g = getGraphics(); 


if ( hasFocus ) 

g.setColor( Color.red ); 
else 

g.setColor( Color.yellow ); 


g.drawRect( 0, 0, r.width-1, r.height-1 ); 
g.drawRect( 1, 1, r.width-3, r.height-3 ); 


The eventHandler class implements the applet itself. The 
reportEvent() method is static so it can be called from outside 
the class without having a specific eventHandle object 
reference. This is one way to solve this problem. There are 
certainly others. We could have retrieved the current applet 
from within the eventCanvas class, coerced that reference to an 
eventCanvas and used it to call reportEvent(). I think the first 
way is better. Any other ideas? Let me know. 

The TextArea variable tArea was also made static so it 
could be referenced from within the static reportEvent. The 
disadvantage here is that this approach limits you to single 
occurances of the applet. Again, I’m definitely interested in 
hearing any other ideas you might have. 


public class eventHandler extends java.applet.Applet 
{ 


eventCanvas eCanvas; 
Static TextArea tArea: 


public void init() 
{ 
add( new Label( “Click and type in this Canvas:” ) ): 


eCanvas = new eventCanvas( 200, 100 ); 
add( eCanvas ); 


add( new Label( “Here’s a list of canvas events:” ) ); 


tArea = new TextArea( 10, 30 ); 
add( tArea ); 
} 


public static void reportEvent( String eventString ) 
{ 
tArea.appendText( eventString + “\r” ); 


Tat NEXT MONTH... 

This was one of the most interesting applets I've worked 
on, both because of the nature of the problem the applet solved, 
and because of the many differences between the various applet 
viewers. Java is still evolving rapidly and the tools will be 
playing catch-up for a while. Have a very happy holiday season 
and I look forward to seeing you allin 1997. 





Visit MacTech Magazine’s Web site! 


nttp://www.mactech.com 
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Eddy Award Winner for Best New Developer Tool 
— MacUser Editors Choice Awards, 1993 


“A distinct improvement over ResEdit.” 


— MacTech /MacTutor 


“Resorcerer’s data template system is amazing!” 
— Bill Goodman, author of Compact Pro 


“Nuke ResEdit! Resorcerer is mission-critical for us.” 
— Dave Winer, Userland Frontier 


“The color pixel editors are wonderful! A work of art!” 
— Dave Winzler, author of Microseeds Redux 


“Every Macintosh developer should own a copy of Resorcerer.” 
— Leonard Rosenthol, Aladdin Systems 


“Resorcerer will pay for itself many times over in saved time and effort.” 


— MacUser review 


“The template that disassembles ‘PICT’s is awesome!” 
— Bill Steinberg, author of Pyro! and PBTools 


“Resorcerer proved indispensible in its own creation!” 
— Doug McKenna, author of Resorcerer 


“...@ wealth of time-saving tools.” 
MacUser Review, Dec. 1992 


Version 1.2.4 


ORDERING INFO 


Needs: >Mac Plus, = Sys 4.2, IMB 
Likes: >Mac Plus, = Sys 7.0, 2MB 
32-bit clean, AU/X compatible 


Price: $256 (decimal) _ 
(Educational, quantity, or 
other discounts available) 


Includes: 500 page manual 
60-day Money-Back Guarantee 
Domestic UPS ground shipping 


Payment: Check, PO's, or Visa/MC 


Extras (call us): 
COD, FedEx, UPS Blue/Red, 
International Shipping 


Downloadable Demos/Updaters: 


AppleLink: Software Sampler 
AOL: Software Libs/Development 
CompuServe: MACDEV/Tools 

or call us. 
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RESORCERER 


The Resource Editor for the Macintosh Wizard 





e New ‘cicn’, ‘ppat’, ‘crsr’, ‘acur’, ‘pltt’, ‘clut’ editors 
¢ Powerful icon family editing (all 9 icon types) 

¢ Color pixel anti-aliasing, dithering, and lots more 
¢ Complete ‘PICT’ disassembly and reassembly 

¢ Resource sorting; ROM resource browsing 

¢ 120 template field parsing types now supported 

e New insertion & deletion template field types 

¢ Text-only ‘PICT’ resources 

¢ Lots of improvements throughout 


New 1.2 Features: 


e Easier, faster, more Mac-like, and more productive than ResEdit 

e Safer memory-based, not disk-file-based, design and operation 

e All file information and common commands in one easy-to-use window 
¢ Compares resource files, and even edits your data forks as well 

¢ Visible, accumulating, editable scrap 

¢ Searches and opens/marks/selects resources by text content 

¢ Makes global resource ID or type changes easily and safely 

¢ Builds resource files from simple Rez-like scripts 

¢ Most editors DeRez directly to the clipboard 

e All graphic editors support screen-copying or partial screen-copying 
¢ Hot-linking Value Converter for editing 32 bits in a dozen formats 

¢ Its own 32-bit List Mgr can open and edit very large data structures 
¢ Templates can pre- and post-process any arbitrary data structure 

¢ Includes nearly 200 templates for common system resources 

¢ TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc. 
¢ Full integrated support for editing color dialogs and menus 

¢ Try out balloons, ‘ictb’s, lists and popups, even create C source code 
e Integrated single-window Hex/Code Editor, with patching, searching 
¢ Editors for cursors, versions, pictures, bundles, and lots more 

¢ Well-designed, helpful developer tools being added all the time 

¢ Relied on by thousands of Macintosh developers around the world 


MATHEMAESTHETICS, INC. 
Box 298 © Boulder * CO ¢ 80306-0298 « USA 
Phone: (303) 440-0707 © Fax: (303) 440-0504 


AppleLink/AmericaOnline: RESORCERER © Internet: resorcerer@aol.com 


By Dave Mark, ©1996 by Metrowerks, Inc., all rights reserved. 
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Marcel Achim, Pascal Reanimator 





This month’s Factory Floor interview is 
with Marcel Achim, the heart and soul of 
Metrowerks Pascal efforts. As Neil never 
tires of reminding me, Pascal is alive and 
well and, in one publisher’s opinion, still a 
wonderful language. 


Dave: How did you hook up with 


Metrowerks? 


Marcel: [| was recruited on the university 


campus by the then VP of Research 
who was teaching there. I became 
involved in an underway project, the 
development of a Modula-2 compiler 
running on various UNIX boxes built on 
MIPS chips. That was my introduction 
to the fascinating world of compilation. 
I started by writing library code and 
translating interfaces from C to Modula- 
2, then I moved on to porting the 
compiler to the different vendor boxes, 
figuring out their idiosyncrasies. 


Dave: Were you doing this work in 


Pascal? If not, when did you bring 
Pascal and Metrowerks together? 


Marcel: The MIPS compilers used a 


frontend/backend architecture with the 
backend being proprietary which 
caused some problems. That lead to our 
need to develop a compiler technology 
where we could hold rights both on the 
frontend and backend. At the same time 
we started another project on the 
Macintosh to provide a Pascal compiler 
along with tutorial and teaching material 
for Macmillan That compiler was built 
around the Modula-2 package available 
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then. So the new technology was meant to provide a solution 
for multiple frontends and multiple backends, and was 
supposed to be the replacement for these versions of Pascal 
and Modula-2. The chosen architecture was a derivative from 
the Oberon architecture developed in Zurich by Nicklaus 
Wirth’s team and was first targeted to the SPARC platform. I 
then implemented Pascal and Modula-2 on SPARC using that 
architecture. We then stopped the development of UNIX 
compilers and I inherited the Macintosh compilers where I 
unified the Pascal and Modula-2 code generators. Around this 
time it was decided that we needed a C compiler, the 
PowerPC was in the air and we received in the mail a terrific 
demo from Andreas. [To hear more about Andreas’s story, 
check back a few issues for the interview with Andreas 
Hommel.] 


Dave: How did the Pascal compiler make the leap to CodeWarrior? 


Marcel: At this point, we had a 68K C compiler with 


optimizations, a split frontend/backend design. Pascal is 
very strong in the developer community (still today 
FileMaker Pro is mostly written in Pascal and is built with 
CodeWarrior). CodeWarrior alone would only be Metrowerks 
C and wouldn’t provide the broader industrial completeness 
and strength that we wanted to provide. So we dropped the 
architecture used on the SPARC, which still didn’t support 
optimizations, and I got the Pascal frontend development 
plus backend/linker modifications, interfaces, libraries and 
utilities. DR/1 was to ship in January with the scheduled 
launch of the first Power Macintoshes. In the mean time, I 
dropped my Masters and stopped teaching. I was giving 
lectures at the university for the past few months along with 
working on my Masters and working part-time on 
Metrowerks compilers. 

MPW Pascal was the chosen dialect because it’s the de 
facto standard Pascal dialect on Macintosh. THINK Pascal 
wasn’t supported and relates heavily to MPW Pascal except 
for a few minor differences. The biggest problem involved in 
developing CodeWarrior Pascal was the universal interfaces. 
Since Apple decided not to support Pascal anymore, the new 
interfaces developed for the introduction of the PowerPC 
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Why so many developers are switching to 
MicroGuard copy protection 


™ 





® MicroGuard is committed to uncompromising © MicroGuard has now surpassed its own 


technological superiority technological lead, actually improving on the best 
"Technology at its peak" is our commitment to you. That is why we have MicroGuard Plus is everything MicroGuard is, plus 40-bit encryption, two 
brought you MicroGuard Plus™. And, MicroGuard Plus is 100% additional passwords, 64-Bit Array, 32-byte public area, 45% size reduction, 
backwards compatible with MicroGuard. This means MicroGuard enhanced counter and more. In addition, MicroGuard Plus offers two new 

and MicroGuard Plus can be used interchangeably. utilities: QuickGuard™ and EasyGuard™ allow you to protect your 


applications without touching your 
source code. The only feature that 
is not plus is the price. :-) 


Just as we promised! 


@ MicroGuard offers you the 





most sophisticated network MicroGuard is the best 
protection selling Macintosh key in 
Our network protection, MicroGuard Net™, the world 


is SO superior, we had to hire an Apple network 


engineer to execute our specifications. MicroGuard sells more Macintosh 


copy-protection keys than anyone else 
in the world! 


@ MicroGuard is the only key 





developed by Mac ® MicroGuard delivers 
developers, and is the first developer support 
and only 100% ADB savvy key within 24 hours 

We have been developing Mac applications as a seed development house We will answer any inquiry you have within 24-hours. We also have a fully loaded 
since 1984. We are not a PC protection company that has come to you AppleLink bulletin board which contains all our libraries, tech notes, Q&A and 
with a Mac product. MicroGuard is fully ADB savvy and offers extended nearly everything you'll ever need! 


addressing. Unlike other protection devices, MicroGuard never clashes 
with other keys. Only MicroGuard offers this level of sophistication. 
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were made, keeping the PowerPC calling conventions in 
mind and making use of C’s syntactic capabilities (for 
example, the CONST keyword is meant to specify an invariant 
pointer parameter and doesn’t have a Pascal equivalent). 

The change from 68K to PPC calling conventions was 
dramatic for Pascal as the passing of value records and 
arrays are not the same. There were two possibilities: either 
support the 68K calling conventions on the PowerPC (thus 
breaking the calling conventions adopted for all languages, 
which were inherited from IBM’s AIX machines and provide 
a seamless common way of doing cross-language, cross- 
vendor routine calls) or modify the interfaces to render the 
expected parameter passing. The 68K conventions pass 
every record and array bigger than 4 bytes by passing a 
pointer. The PowerPC passes value records into registers 
and on the stack, and all arrays by pointer regardless of the 
size. To be able to match both PowerPC and 68K 
conventions with the same set of interfaces could have been 
achieved by using a new parameter passing method using 
the CONST keyword that would have the semantics of a 
value parameter and an efficient passing implementation. 
This solution wasn’t taken because it would have broken 
some compilers. The retained solution was to use VAR 
parameters because they force the use of pointers, but it has 
the drawback of breaking some user code, especially in the 
case of packed arrays and records. 

The other problem encountered on the PowerPC is the 
signatures. They are packed arrays of 4 chars, so they’d have 
to be passed by pointer. But their C equivalent is an 
unsigned long, thus value not pointers. To get this to work I 
had to introduce on PowerPC an UNSIGNEDLONG data 
type that’s compatible with packed arrays of 4 chars so 
OSTYPE can be used without problems. After 2 years of use, 
this solution to the Universal Interfaces problem has proven 
to be the right one. Another conclusion that comes up is the 
need to add a procedural data type to Pascal. The new data 
type enables the compiler to do type checking on the 
callback routines that get passed either to user code or the 
toolbox. This type checking capability has proven to be very 
effective in the porting of code from 68K to PowerPC. 


Dave: So at this point, we have the first CodeWarrior IDE with 


Pascal and C/C++. Since plugins weren’t introduced till CW6/7, 
how did the Pascal compiler work? 


Marcel: The first releases of CodeWarrior didn’t used the 


plugins architecture but a common IDE was always in the 
air as the cornerstone of CodeWarrior. The new PowerPC 
machines had more resources and made such a design more 
interesting for an entire IDE. So along with the C/C++ 
compiler, the Pascal compiler was compiled and linked 
along with the IDE sources. It wasn’t that the Macintoshes 
were too slow or the resources poor, it was just that it wasn’t 
the way to do things. People knew about their machine 
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constraints and didn’t go for blue sky, so the applications 
were kind of in scale with the hardware capabilities. Now 
that we have faster and bigger machines it is possible to add 
on facilities to the programs and these added facilities eat up 
not only disk space but also memory. So having the ability 
to load on demand various parts of a program has been 
around almost as long as computers. It’s the way of doing it 
that changes over time and across platforms. 


Dave: Can You talk about the difference between the C++ 


“value model” and Object Pascal’s “reference” model? 


Marcel: The object model is the underlying runtime model that 


affects the aspect and behavior of objects. In Object Pascal 
the object model used is known as the reference model 
because you have to explicitly invoke the creation and 
deletion of objects. On the other hand, C++ and Turbo 
Pascal use the value model which involves far more 
complex semantics for manipulating objects. People often 
mix method binding with the object model. This accounts 
for some misconceptions. In Object Pascal, the language 
only allows compile time binding determination for 
‘inherited’ method calls. All the other methods can be 
overridden, thus forcing late binding which can be changed 
by a clever linker for monomorphic methods (methods that 
are never overridden within the program). 

In C++, member functions need the ‘virtual’ keyword 
to specify polymorphism, thus helping the compiler decide 
how to perform the method call. (It gets more complicated 
when multiple inheritance is involved.) This binding facility 
is partially lifted by the introduction of procedural types in 
CodeWarrior Pascal, but still has to be hand constructed 
along with the data fields when the object gets created. The 
difference between object models comes to light when you 
look at the copy semantics. In Object Pascal, assigning one 
object to another, passing it as a value parameter or 
returning one as a function result doesn’t create a new 
instance as in C++ (and associated copy constructors) or as 
in Turbo Pascal (bug prone object casting), but only copies 
a reference. In Object Pascal cloning an object requires a 
method call and is explicit. This greatly simplifies the 
complexity of the program without limiting the functionality. 


Dave: What are some of the differences between CodeWarrior 


Object Pascal and other dialects of Object Pascal? 


Marcel: There are as many Pascal dialects as there are vendors. 


One of the biggest contenders is Turbo Pascal. The differences 
can be categorized into three fields; runtime support (mostly 
IO and platform specific stuff), the enhanced syntax, and 
finally the class and object models. We’ve already discussed 
the object model. The most apparent IO difference between 
Object Pascal and Turbo Pascal is TP’s assign routine, which 
binds a logical file to a physical file. Under Object Pascal this 
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is performed directly by the opening routines. 

The other IO differences lie in file access semantics, 
mostly for the handling of binary files. The original Pascal’s 
(and also the ANS standard) way of dealing with them is using 
get/put and direct file access thru the caret operator ‘file’. The 
object support is very different. OP implements a very simple 
syntax that hasn’t evolved in about 10 years, whereas TP went 
through a constant evolution of their implementation. This is 
clearly an area where we have to expand OP’s capabilities 
because it really represents an advantage to programmers to 
have a more flexible implementation. 


Dave: What are you working on now? 


Marcel: My group is currently working on a Windows version 
of CodeWarrior Pascal. We are also developing a tool that 
will automate the use of C precompiled headers within 
Pascal as Pascal support is more and more lacking within 
Apple and nonexistent on Windows. 


Dave: What do see in the future for yourself and for Pascal? 


Marcel: | think in the near future we’re going to see some kind 
of reevaluation of project development using C/C++ as 
metrics, and studies are going to circulate. I think that there 
could be some kind of backlash toward Pascal and Ada if 
the figures show that C/C++ didn’t deliver the expected 
results. As far as Pascal goes, from the market share 


perspectives, Pascal is a player in the academic market as most 
attempts to move to C and C++ didn’t work very well. 

On the other hand, in software engineering things are 
different. Pascal would have to evolve much faster to meet 
today’s software engineering needs and standardize on a wide 
variety of platforms. Even then I’m not too sure about the 
prospects. As for me, I’m linked to Pascal as I want to evolve 
CodeWarrior’s implementation of Object Pascal to be a player in 
both the Macintosh and Windows Pascal market. 


Marcel Achim is the current Pascal resident at 
Metrowerks. He takes care of everything related to Pascal and 
runs the Montreal engineering office. Marcel has been with 
Metrowerks for the past 6 years and worked on various 
compiler projects on Unix, Macintosh and PC. Marcel was 
born, and still lives in Montreal, with his wife, one year old 
daughter, and two cats. In their spare time, they enjoy playing 
with the baby and planning the renovation of an old Victorian 
cottage they recently purchased. Marcel likes canoeing and 
wilderness camping. “Once, I was alone in the middle of 
nowhere, and a black bear was standing between me and my 
canoe, looking me straight in the eyes. Smelling his bad 
breath, I turned and walked up the trail with him following 
me. After a few seconds I turned around and started to yell 
and wave my arms until he finally ran into the bushes. I didn’t 
sleep well that night!” [iu 













Here at MacTech Magazine, we rely heavily 
on outside writers for most of the material that 
appears in our pages. If readers did not 
participate in the magazine, sending us their 
ideas and taking the time to write articles, there 
would be no MacTech. MacTech Magazine is 
not a staff of writers sending a constant stream 
of one-way messages outwards; it’s a living, 
evolving network of readers conversing with 
one another, educating one another, sharing 
their knowledge, their experience, their 
interest, their trials and tribulations and joys 
and successes in the constantly unfolding story 
of programming the Macintosh. MacTech 
Magazine doesn’t just happen: it’s what the 
community makes it. If we carry reports of 
future trends and technologies, if we teach 
useful methods, if we review new books and 


tools, if we provoke thought, provide help, 
ride the wave of current interests and 
concerns, it is only because we reflect the 
thoughts of our readers, who speak through 
our pages. 

You are invited to involve yourself in 
this exciting conversation amongst readers. 
No matter who you are, no matter what 
your credentials may be, if you have a tale 
to tell, a trick to share, a technique to teach, 
we want you to consider joining the family 
of those who write for MacTech. 

Don’t just wait for a topic to be 
covered or a technique explained in 
MacTech! Take responsibility! Write us an 
article yourself! 

To write for MacTech, just send for our 
Writer’s Kit. It’s a Microsoft Word file 


Heve MAKE MAcTECH Work 


containing the Styles you need to use, and 
giving lots of helpful advice and information, 
including all the legal stuff. You can let us 
know what you’re writing about, or, if you 
want to, you can just write the article and 
spring it on us when it’s done. [Note: We 
also have a need for people willing to make 
themselves available to write occasional 
product/book reviews.] If we publish your 
article, you'll be paid for it! 

Write to us, the editorial staff, at 
editorial@mactech.com (or one of the other 
addresses listed on page 2 of the magazine). 
Take the future of MacTech Magazine into 
your own hands! 


For Macintosh 
Programmers & Developers 
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by James George, Los Alamos, NM 
Registration Tools 


Tools for Providing 
Convenient Registration for 


Shareware 


As we put the finishing touches on our 
shareware masterpieces, we realized that we 
had forgotten a vital link — a convenient 
registration method to encourage users to 
register and pay for the shareware. We 
looked around and found none, but 
MacTech saved the day with a timely article 
suggesting what was needed (Bill Midesitt 
— “How to Make $1,000 Per Week Stuffing 
(Virtual) Envelopes, July 1995). We’ve 
implemented many of the suggestions for 
the Metrowerks environment in Pascal or C. 

We wanted an easy to include module 
which a) kept asking the user to register, b) 
provided an easy way for a user to register, 
c) allowed the author to create registration 
numbers, and d) allowed any user to un- 
register a registered copy to be distributed 
freely. Thus, Register includes the headers, 
functions, and resources providing the 
entire user interface and prints the 
registration form for mailing or faxing. 

Include Register in your Metrowerks 
project by adding Register.c and Register.rsrc 
to your project , and inserting two lines in 
your setup/main module. 





Listing 1: Typical Mac Template 





Typical Mac Template 
Include the Register headers, and check the registration. 
#tinclude “Register.h” 


main() 
{ 


(*call usual Macintosh initialization setup routines *) 
CheckRegistration() ; 


(* do your event loop *) 


THE USER INTERFACE 

As your application starts, CheckRegistration retrieves the 
registered name and registration number from the resources, 
recomputes the registration number from the name and 
compares it to the registration number from the resource. If 
these match, CheckRegistration returns and your application 
continues normally. When they do not match, a information 
dialog encourages the user to register. 


| Registration provides an easy way for "Shareware Authors" to 
; implement a registration number and encourage user's to send in the 
; registration. Registration features: 


* Name driven registration # 
¢ Prints a registration page 
* Calculates the registration # 


eC, C++, and Pascal versions 
¢ Metrowerks implementation 


Registration is distributed as shareware. You are permitted to use 
it on a trial basis for up to 30 days. If you wish to continue using 
the product beyond that period, you are expected to pay a 
registration fee of $0, and register. 


i Please support the shareware concept and register your copy! 





THIS 1S AN UNREGISTERED COPY 


Figure 1. The Information Dialog 


James George has developed and marketed Macintosh products along with consulting and contract programming for other 
Macintosh products; d.b.a. Mesa Graphics, Inc. Registration tools was developed and used in several shareware products 
available from any of the “info-mac-mirror” sites; (see, http://www.mesagraphics.com/~guru ). Currently, he investigates 
advanced desktop technologies for a project at Los Alamos National Laboratory. (guru@mesagraphics.com or 


george @sigeraph.org) 
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Shift your development projects into high gear with MacA&D software engineering tools! 





victionanur 5) Successful software development requires an 
int ein aa Named | understanding of what needs to be done, a plan for how to 
TShape . ° . 
Tshape’fPos ton do it and a structured approach to completing the job. 
ape electeé ° ° ° 
dang og event MacA&D can help by simplifying system analysis and 
TShape . Free oMous . °f ° ° ° 
TShope, initialize SaieNe requirements specification, automating popular modeling 
TShape . Read . . ° ° 
TShape Select : i techniques for designing your software and generatin 
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2 roduce a quality product. 
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Initialize 


Powerful capabilities are just one MacA&D advantage. 
It’s easy-to-use and includes an extensive set of examples 
and tutorials. MacA&D and WinA&D products can share 
documents, so your project team can use Macintosh, 
Solaris, HP-UX, Windows 95 or Windows NT computers. 
You can even switch design methods or pick and mix the 
best of each, so your design work always stays current. 
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Code: Order.SQL 
CREATE TABLE client 
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client_number INTEGER NOT NULL, 

client.name CHARACTER‘40>, 
clientwaddress CHARACTER‘40>, 
PRIMARY KEY (cl ient_number > 
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Data modeling and SQL generation for Information Engineering, Chen... 


M a C A & I) New WinA&D for Windows 95 & Windows NT! 
Call for MacA&D or 


WinA&D brochures Excel Software 
or fax 515-752-2435 515-752-5359 


casetools @ aol.com. 





http: / /www.excelsoftware.com 


MacAnalyst, MacDesigner, MacA&D, WinA&D and Translator are trademarks of Excel Software. Copyright 1996. All rights reserved. 





Naturally, only the item numbers for the “Register” and 
“Not Yet” button are important, the rest of the dialog can be 
modified to promote your application. 


If the user chooses “Not Yet”, the application continues 
normally; but, if “Register” is selected, than the registration 
dialog allows the information to be entered 








| To register your copy of Registration, Mesa Graphics, Inc. 
| send a Post Card (or email) with your 411 Cheryl Ave. 

; name, address, and name of the Los Alamos, NM 87544 

| product you are putting it in, to: Internet: george@siggraph.org 







You will not receive a registration number which you may enter 
to eliminate these registration screens. 


Address 








Figure 2. The Registration Dialog 


The user enters everything but the Registration Number, clicks 
“Print”, and sends the printed form and fee to YOU! If the user 
clicks “Cancel” no information is remembered; if the user click 
“OK”, everything is remembered except the credit card information. 

When you receive the registration, you fire up your master 
copy, enter some special command and the MakeRegistration 
dialog allows you to enter the information, create a valid 
registration number from the users name (click on “Make 
Registration”), and print the information to return to the user. 





| To register your copy of Registration, Mesa Graphics, Inc. 
| send a Post Card (or email) with your 411 Cheryl Ave. 
/ name, address, and name of the Los Alamos, NM 87544 
product you are putting it in, to: Internet: george@siggraph.org 












You will not receive a registration number which you may enter 
to eliminate these registration screens. 










User Name: | John Doe 






Address 





City, ST, ZIP |Anywhere, ST 12345 


MC/Visa/AEX | 9000-0000-0000-0000 EXP | 7/94 


Registration Number: 


Make Registration 













Figure 3. The Make Registration Dialog 


THE DETAILS 
Now let’s look at the code in detail. 
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Listing 2: Register.h 





Register.h 


#define lockedAlert 400 /* application locked alert */ 


#tdefine shareSplashAlert 401 /* the info screen */ 


define registerDLog 314 /*the register dialog */ 
fdefine regPrintItem 3 
#define regMkPwdItem 4 
define regFrstPrtItem 5 
#define regLastPrtItem 19 
define regFrstOtherSaveltem12 
define regLastOtherSaveltem13 
#define regNameItem 11 
#define regNumberItem 19 


define regDataResType ‘ABCD’ 


define regNumSeedValue 1234 /*seed value for test */ 


typedef long *longptr, **longhan; 
/* Prototypes */ 


void PrintRegForm(DialogPtr theDialog); 
long ComputeRegistration(Str255 name); 
void MakeRegistration(void) ; 

void UnRegister (void) ; 

void Register(void) ; 

void CheckRegistration(void) ; 


lockedAlert is the id for the alert which informs the user that 
the application is locked and thus no registration information can 
be remembered. The “OK” button must remain item 1. 

shareSplashAlert is the id for the information alert which 
describes the features of the shareware and encourages the 
user to register. The item numbers for “Register” and “Not Yet” 
item numbers must remain unchanged, but the rest of the 
dialog may be modified. 

registerDLog is the id for the registration (and make 
registration) dialog. The “OK” and “Cancel” item numbers must 
remain unchanged, but the rest can be moved as long as the 
appropriate defines are changed. regPrintItem is the “Print” 
button and regMkPwdltem is the “Make Registration” button. 
The items from regFrstPritItem thru regLastPrtItem are printed 
when the “Print” button is selected. The regNameltem, the 
regNumberltem and the items from regFrstOtherSaveltem thru 
regLastOtherSaveltem are saved in the resource file in the 
resource type regDataResType. 

regNumSeedValue is used by the ComputeRegistration 
routine as the seeded initial value. 

longptr and longhan are two data types used, and the 
prototypes are the actual routines. 

Now, lets look at all of the routines which comprise the 
registration module; they are in Register.c 

The registration number is calculated from the name by 
ComputeRegistration. 
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Listing 3: ComputeRegistration 





ComputeRegistration 
long ComputeRegistration(Str255 name) 
{ 


long regnum; 
short i; 


if (StrLength(name) == 0) regnum = -1; 
else regnum = regNumSeedValue; 
for (i = 1; i<= StrLength(name); i++) 


regnum = regnum + name[i]; 
return (regnum) ; 


This computes a registration number for a name, by starting 
with a seed value, and adding the character code for each 
character of the name, in order. Although not unique, this 
allows for many variations by shareware authors. Some of the 
variations are to change the seed, different arithmetic on 
individual characters (twice the value, three times the value, 
alternately add and subtract...). Even these simple techniques 
can be quite hard to break for the average user, but only a brain 
teaser for the dedicated hacker. 

After an application has started and initializes the 
Macintosh required managers, it only needs to call 
CheckRegistration to implement most of the registration 
functionality; the enhancements will be discussed later. 


Listing 4: CheckRegistration 





CheckRegistration 
// CheckRegistration verifies the remembered name and registration number and asks 
// the user to register the software if the verification fails. 


void CheckRegistration(void) 
{ 
StringHandle namehan; 
longhan regwdhan; 
long inregwdnum, computeregwdnum; 


namehan = 
(StringHandle) GetResource(regDataResType, 
regNameltem) ; 
regwdhan = 
(longhan) GetResource(regDataResType, 
regNumberItem) ; 
if ( (namehan != nil) && (regwdhan != nil) ) 
{ 
if ( 
(GetHandleSize((Handle) namehan) > 1) && 
(GetHandleSize((Handle) regwdhan) == 4) 


HLock( (Handle) namehan) ; 

HLock( (Handle) regwdhan) ; 

computeregwdnum = ComputeRegistration(*namehan) ; 
inregwdnum = **regwdhan; 

HUnlock( (Handle) namehan) ; 


HUnlock( (Handle) regwdhan) ; 


if ( namehan != nil) ReleaseResource( (Handle) 
namehan) ; 

if ( regwdhan != nil) ReleaseResource( (Handle) 
regwdhan) ; 


regwdhan = nil; 
namehan = nil; 
if ( inregwdnum != computeregwdnum) Register(); 


} 
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} else 


{ 


if ( namehan != nil ) ReleaseResource( (Handle) 
namehan) ; 

if ( regwdhan != nil ) ReleaseResource( (Handle) 
regwdhan) ; 


Register (); 
} 


CheckRegistration gets the remembered name and 
registration number from the regDataResType resource. If either 
is not there, then Register is called, otherwise a registration 
number is calculated from the remembered name and 
compared to the remembered registration number, and if they 
differ, then Register is called. 


Listing 5: Register 








Register 

void Register (void) 

{ 

DialogPtr theDialog; 

Handle theTextHdl; 

Rect itemBox; 

short itemHit, theType, index; 
GrafPtr thePort; 

Str255 namestr, regstr; 

long regwordL; 
StringHandlenameHan, strHan; 
longhan regsHan; 


FlushEvents (everyEvent, 0); /*throws out leftover events */ 
if ( Alert(shareSplashAlert, nil) == OK ) 
{ 
FlushEvents (everyEvent, 0); 
theDialog = 
GetNewDialog (registerDLog, nil, (WindowPtr) 
=1)5 
if (theDialog != nil) 
| 
/*Hide the Make Reg Number 
button*/ 
HideDialogItem(theDialog, regMkPwdItem) ; 


/*fill in text fields from save 


values*/ 
strHan = 
(StringHandle) GetResource(regDataResType, 
regNamelItem) ; 
it ( srrfan f= nil) 


{ 
GetDialogItem (theDialog, regNameItem, &theType, 


&theTextHdl, &itemBox) ; 
SetDialogItemText (theTextHdl, *strHan) ; 
ReleaseResource((Handle) strHan); 


} 


for ( index = regFrstOtherSaveltem; 
index <= 
regLastOtherSaveltem; index +t) 
{ 
strHan = (StringHandle) GetResource(regDataResType, 
index) ; 
a: (Sitrhan. I= aL) 
{ 
GetDialogItem (theDialog, index, &theType, 


&theTextHdl, &itemBox) ; 
SetDialogItemText (theTextHdl, *strHan); 
ReleaseResource((Handle) strHan) ; 
} 
} 
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For C and C++ Developers .... 


When the Te 


Are you writinga... 
¢ Document Viewer? 

Multimedia Product? 
Report Generator? 
Forms Package? 
HTML kditor? 
Email Application? 
Electronic Book Technology? 
Hypertext Enabled Program? 
Program with text features? 


Then you need PAIGE. 

PAIGE™ is a library of run-time 
functions you can embed into your 
application. It will add virtually unlimited, 
programmable “rich edit” word processor and 
page layout features to any part of your program. 


PAIGE will save you hundreds of precious development 
hours. Better yet with PAIGE’s cross-platform API you can 
support the most popular desktop operating systems. 


Lanything into text 
WoerldScript Support 


ort & Export RTF 
full MFC support 
* Royalty Free 


-32/-6703 


DataPak Software Inc. 


Internet: sales@datapak.com CS: 76424,3027 Ph: 360-891-0542 
www.datapak.com/~ datapak/mct AOL: DATAPAK1 Fx: 360-891-0743 


Windows 3.1 ° Windows 95 ¢ Windows NT ¢ Macintosh « PowerMacintosh 


GetPort (&thePort) ; 
SetPort (theDialog) ; 
ShowWindow (theDialog) ; 


do 
{ 
ModalDialog (nil, &itemHit) ; 
if ( itemHit == regPrintItem ) 
PrintRegForm(theDialog) ; }while (itemHit > cancel); 
if ( (itemHit == ok) || (itemHit == regPrintItem) ) 


{ 
GetDialogItem (theDialog, regNameItem, &theType, 


&theTextHdl, &itemBox) ; 
GetDialogItemText (theTextHdl, namestr); 
GetDialogItem (theDialog, regNumberItem, &theType, 


&theTextHdl, &itemBox) ; 
GetDialogItemText (theTextHdl,regstr); 
StringToNum(regstr, &regwordL) ; 
if ( Length(namestr) > 0) 
{ 
UnRegister(); 
regsHan = (longhan) NewHandle(A4); 
nameHan = NewString(namestr) ; 
**regsHan = regwordL; 
AddResource( (Handle) nameHan, regDataResType, 


regNameItem , “\p”); 
if ( ResError() != noErr) 
{ itemHit = 
StopAlert (lockedAlert,nil) ;} 
WriteResource( (Handle) nameHan) ; 
AddResource( (Handle) regsHan, regDataResType, 


regNumberItem , “\p”); 


if ( ResError() != noErr) 
{ itemHit = 
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StopAlert(lockedAlert,nil); } 
WriteResource( (Handle) regsHan) ; 
UpdateResFile(CurResFile()); 
for ( index = regFrstOtherSaveltem; 
index <= 
regLastOtherSavelItem; indextt) 


{ 
GetDialogItem (theDialog, index, &theType, 


&theTextHd1, &itemBox) ; 
GetDialogItemText (theTextHdl,namestr) ; 
nameHan = NewString(namestr); 
AddResource( (Handle) nameHan, regDataResType, 


index , “\p”); 
if ( ResError() != noErr) 
{ itemHit = 
StopAlert(lockedAlert,nil); } 
WriteResource( (Handle) nameHan); 
UpdateResFile(CurResFile()); 


/*of ok || regPrintItem] */ 


DisposeDialog(theDialog) ; 
SetPort(thePort) ; 
SetCursor (&qd.arrow) ; 


Register puts up the information dialog (the shareSplashAlert), 
and if the user selects the “Register” button, it puts up the 
registration dialog, prints whenever the “Print” button is clicked, 
and exits when “OK” or “Cancel” is clicked. When “OK” is clicked, 
various entered data is remembered; the name, registration number, 
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The changes in the About.. module are to retrieve the 
name from the resource file and display it. If “Unregister” is 
clicked on, then the unregister module is executed. 


Listing 8: AboutApplication 





AboutApplication 


void AboutApplication(void) 
{ 
short tmpInt; 
StringHandle regnameHan; 


regnameHan = (StringHandle) 


GetResource(regDataResType, regNamelItem) ; 

if ( regnameHan != nil) 

{ 
HLock( (Handle) regnameHan) ; 
ParamText( *regnameHan, “\p”, “\p”, “\p”); 
HUnlock( (Handle) regnameHan) ; 
ReleaseResource( (Handle) regnameHan) ; 

} else ParamText( “\p”, “\p”, “\p”, “\p”); 


tmpInt = Alert(applicationAboutlId, nil); 
if ( tmpInt == aboutUnregisterItem) UnRegister(); 
} 
The UnRegister module deletes all of the user data; name, 
address... from the resources. This results in a version which 
reverts and asks for the shareware to be registered. 


Listing 9: UnRegister 





UnRegister 
void UnRegister (void) 


Handle tmpHan; 

short index; 

do 

{ 
tmpHan = GetResource(regDataResType, regNameltem) ; 
if (tmpHan != nil) 
{ 


RemoveResource(tmpHan) ; 

DisposeHandle(tmpHan) ; 

UpdateResFile(CurResFile()); 
} while (tmpHan != nil); 


do 
{ 
tmpHan = GetResource(regDataResType, regNumberItem) ; 
if (tmpHan != nil) 
{ 
RemoveResource(tmpHan) ; 
DisposeHandle(tmpHan) ; 
UpdateResFile(CurResFile()); 
} 
} while (tmpHan != nil); 


for (index = regFrstOtherSaveltem; 
index <= regLastOtherSaveltem; 
indext+) 
do 
{ 
tmpHan = GetResource(regDataResType, index) ; 
if (tmpHan != nil) 
{ 
RemoveResource(tmpHan) ; 
DisposeHandle(tmpHan) ; 
UpdateResFile(CurResFile()); 
} 
} while (tmpHan != nil); 
} 


DECEMBER 1996 @ MACTECHMAGAZINE 


SUMMARY 

Registration Tools provide a convenient package for 
generating a registration number based upon a name, gently 
encouraging the registration of the shareware, providing printed 
forms for ease of registration, and supporting the broad 
distribution of unregistered copies. These tools were written 
with the philosophy that shareware users will register for 
modest fees if the software performs desired functions, and they 
are tactfully reminded; we believe that the best way of 
evaluating shareware is to provide fully functioning software, 
with documentation. 

Registration Tools does not provide copy protection, in fact 
the user is encouraged to UnRegister and distribute copies! In 
our examples, the registration is checked only at the beginning 
and the tests were built with symbol tables enabled; thus, it can 
be hacked quite easily with a debugger/disassembler. There are 
many improvements and variations to make “hacking” more 
difficult but most of us would prefer to get on with creating 
great shareware for the Macintosh! 

We appreciate the excellent review by a MacTech reviewer, 
and the following is a quote from that review. 

So that there is no misunderstanding, it should be made 
clear that neither the reviewer nor the magazine condone 
hacking as a way of avoiding payment to authors of 
commercial or shareware software. The point of this response 
is to point out to shareware authors the ease with which 
registration schemes can be bypassed, so that they are under 
no illusion about the security provided by these schemes. The 
Registration Tools approach is an effective way to remind 
users that a shareware fee needs to be paid, while allowing 
them the opportunity to try out all of the features of the 
software before deciding whether to purchase it, but it is not a 
copy protection scheme. HW 


Visit MacTech Magazine’s Web site! 


http://www.mactech.com 
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THE TRADE 





By Cliff McCollum, Victoria, British Columbia, Canada 


SoftPolish 


How Bare Bones Software 
has made quality 
assurance easier 


“It DOESN’T SUCK EITHER” 

Bare Bones Software is best known for its 
powerful text editor BBEdit. Anyone who 
has been to Apple’s Worldwide Developer 
Conference has seen their famous BBEdit 
T-shirts that proclaim “It Doesn’t Suck.” At 
the next WWDC, they should distribute 
SoftPolish T-shirts that read “It Doesn't 
Suck Either.” Bare Bones Software 
describes SoftPolish as “a tool that helps 
software developers deliver clean and 
consistent applications.” It easily delivers 
on this promise, and is a nice example of 
a program that focuses on doing one thing 
and doing it well. SoftPolish quickly 
locates many of the common, and some of 
the uncommon, easily fixed problems that 
can turn into costly mistakes if they remain 
in the final shipping product. 

A complete installation of SoftPolish 
requires a littlke under one megabyte on 
your hard drive, and prefers 1300k of 
RAM to operate. Version 1.2 is not 
PowerPC native, which may give you 
time for a few extra walks around the 
cubicles. On a 7200/90, a typical one 
megabyte application took about a 
minute to test. The more errors a file 





contains, the longer the test will take. 

I tested SoftPolish initially on some of my own projects. I 
found it quite surprising that there were a number of not so 
subtle errors in each application. The most common thing 
SoftPolish found was my incorrect placement and sizing of 
dialog buttons. I consistently put them too close to my dialog’s 
borders, and usually made them too small. SoftPolish also 
pointed out my numerous typos in menus, strings, and dialogs. 
Just for fun, I tested Excel 5. The check itself took three-and-a- 
half minutes, and found many fascinating typos, including 
“itmes,” “returnd,” “seleciton,” and “measurment.” Acquiring 
SoftPolish has permitted me to spend more time testing 
program code and less time inspecting interfaces. 
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LEARNING THE ROPES 

The well written documentation covers all of the important 
aspects of the program. The documentation starts with a 
discussion of how to use SoftPolish as part of a formal quality 
assurance program, and then moves on to discuss the program’s 
capabilities and how they are used. A short, but complete 
tutorial walks you through each SoftPolish function by testing a 
small and thoroughly troubled program supplied on the 
SoftPolish CD-ROM. There is Technical Support provided via 
Email, should you find a need for it. 


THE SOFTPOLISH INTERFACE 

You can almost completely control SoftPolish from a simple six 
button window called the SoftPolish Navigator (see Figure 1). The 
first five buttons in this window activate the SoftPolish functions in 
the order they are typically used. The sixth button displays on-line 
help. The only SoftPolish function not represented in this window is 
“List Resource Strings.” This lists all the strings found in a files 
resource fork — including those found in dialog boxes, and Apple 
Event terminology (“aete”) resources. 


Cliff McCollum has been developing Macintosh software for over five years. He holds a degree in Computer Science from 
the University of Victoria, where he works as a programmer in their computer science department. His personal business 
(Blue Globe Software) has released two popular shareware programs for the Mac (AliasZoo and Keys Off). When he is not 
spending time with his wife Deanna and his two year old son Zachary, he enjoys mountain bike riding. You can reach him at 


<http://www.blueglobe.com/~cliffmec>. 
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Copyright © 1996 Bare Bones Software Inc. All Rights Reserved. 
Figure 1. The SoftPolish Navigator. 


Bare Bones has made SoftPolish quick and easy to use. It is 
unlikely that you will ever need to do more than launch SoftPolish, 
click a few buttons, view the resulting report, and then return to 
your development environment. Because SoftPolish is so quick 
and easy, you can include an analysis of your application in even 
the tightest development schedules. 


DIAGNOSTICS 

The four groups of diagnostics that SoftPolish performs are 
user interface, resource validity, spelling checks, and cleanup 
suggestions. In total, there are 18 individual tests that you turn 
on or off as your needs dictate. 

SoftPolish can only check those aspects of a program that are 
visible in the program’s resources. It cannot check for bugs in 
your code, or detect possible problems caused by the program at 
runtime. For this reason, SoftPolish is most effective if your code 
uses unmodified resources directly from a resource file. 


User Interface 
This group tests the elements visible to users. 

e Duplicate or misused menu command key equivalents. 

e Improperly capitalized menus, menu items, window names, 
and control titles. 

e Interface elements that will not fit within a compact Mac’s 9” 
screen. [Although this test may be somewhat outdated. — err] 

e Text elements that may not be large enough to display 
their contents. 

e Dialog items check for items outside of the dialog’s display 
area, overlapping items, items larger or smaller than Apple 
recommends, and items that are too close to a dialog’s border. 

e Improper use of non-curly quote marks and apostrophes. 

e Incorrect use of three periods in place of the ellipsis character. 

e Duplicate spacing between words or sentences. 
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Some of the warnings generated from these tests can be 
misleading — for example, the suggestion that all static text 
boxes must be a multiple of 16 pixels tall. However, these 
warnings can still prove very useful in finding problems that 
you may not have otherwise noticed. 


Resource Validity 

This group tests for things that are not usually visible to 
users, but that are required to ensure proper operation. 

e Correct use of resource types. For example, if you identify 
your target file as being a non-Apple file, SoftPolish will flag 
improper use of resource types reserved by Apple Computer. 

e Internal consistency checks, such as a “vers” resource that 
contains inconsistent version data. 

¢ Compatibility checks identify incomplete icon families, SIZE 
bits set to impossible combinations, color PICTs (these may 
not display properly on B&W Macs) and other similar 
situations. 

e Size checks verify certain standardized resources for correct 
size. For example, all ICONs should contain 128 bytes. 

¢ Properly linked resource checks that all referenced 
resources, such as DITLs referenced from DLOGs, are 
present. It also warns of orphaned resources, like a “wetb” 
resource without a corresponding “WIND”. 

Resource Validity warnings are critically important. Unlike 
errors from the other groups that flag cosmetic problems, 
resource errors can result in improper program execution or 
even crashing. 


Spelling 

SoftPolish can verify spelling both in a files resource fork, 
and in its file name. SoftPolish ships with pre-built dictionaries 
for US English, British English, Dutch, French, and Spanish. In 
addition, SoftPolish can automatically build Custom dictionaries 
using your target as a model. (See the section titled “Building a 
User Dictionary.”) You can also build custom dictionaries using 
BBEdit or another text editor. 


Suggest Cleanup 
The Suggest Cleanup group reports on many common 
situations that are not incorrect, but tend to lower the quality 
of a product. 
e Empty resource forks. 
¢ Unwanted resource types. Use this test to locate resources that 
should be removed before your final product ships. Template 
(“TMPL”) resources are a common unwanted type. 
¢ Code resources that contain debugger calls or MacsBug names 
(only checks 68k code). 
Suggest Cleanup will also display every “vers” resources it 
finds, giving you an opportunity to verify that they are correct. 
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UsING SOFTPOLISH 

Testing a product with SoftPolish involves five steps. Some of 
these will be carried out repeatedly during development. Others 
may be used only once — right before freezing a shipping version. 
To give you a feel for how to use SoftPolish, I will describe each 
step you would take to test a fictitious application named “Super 
Whizzy Write.” If you want to follow along, a demo version of 
SoftPolish is available from Bare Bones Software’s web page at 
<ftp://ftp.barebones.com/pub/demos/SoftPolish_1.2_Demo.hgx>. 


Choosing a Target 

SoftPolish can scan a single file, the contents of a folder, or 
even an entire disk (though you’d have to be pretty patient with 
the last one.) Clicking the Choose Target button in the SoftPolish 
Navigator window brings up a standard open dialog box. Locate 
“Super Whizzy Write” on your hard drive, and click OK (if you 
are actually following along, you'll have to pick some other 
application.) With a target chosen, your next step is to build a 
user dictionary. 


Building a User Dictionary 

In order to avoid flagging correctly spelled words as 
misspelled, Bare Bones recommends that you build a user 
dictionary before conducting a complete scan. By building the 
user dictionary, you specify the correct spellings for words that 
are unique to your application. SoftPolish then uses this 
dictionary while analyzing your application. 

Click the Build User Dictionary button to create a custom 
dictionary for Super Whizzy Write. In the Build User Dictionary 
window, the Build button locates and displays the first unknown 
word in your program. Click the Learn button if you want to add 
the word to your dictionary, or the Skip button if you do not 
want to add the word. SoftPolish moves through all the 
unrecognized words while you choose to learn or skip each 
one. A log of all the words added to the user dictionary is kept 
in case you require it for auditing purposes. 


Scanning the Target 

Once your user dictionary is built, you are ready to begin 
scanning for errors. 

As it scans the target(s), SoftPolish produces a problem report. 
You can format the body of each problem report in one of two 
ways, “by file” or “by problem.” You must set the desired report 
format in the SoftPolish preferences dialog before you begin a 
scan. For this example, if you want to keep all the test results 
for a single file grouped together, you should select “by file.” If 
you wanted to keep the results from each individual test 
grouped together, you would choose “by problem.” 

Clicking the Scan Target button displays the following 
window (see Figure 2). In this window you can turn on or off 
each of the tests discussed in the previous section. Once you 
have selected the tests of interest, click the Scan button. 
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Figure 2. The Scan Target window allows you 
to turn individual tests on or off. 


SoftPolish scans the target file(s) and produces a problem 
report. A typical report is quite long, but Bare Bones has tried to 
format them for easy reading. The start of each report contains a 
summary of the tests performed during that scan, followed by a 
listing of the problems found. I have included a sample problem 
report in the next section. You can print out the completed 
report, save it to disk, or edit it directly in SoftPolish. 


Correcting Spelling 

Although scanning Super Whizzy Write highlighted any 
spelling errors present, it made no attempt to fix them. To begin 
spelling corrections, you must click the Correct Spelling button in the 
Navigator window. Spelling error correction in SoftPolish works as it 
does in most word processors. Each suspected error is displayed, 
and alternate correct spellings are suggested. Then you are asked to 
either correct the word, ignore it, or add it to your User Dictionary. 


Cleaning Up 
You perform many of the final steps required before freezing 
each version of your program in the Clean Up window. 
e Set the modification and creation dates for all files and 
folders to matching values. 
e Remove empty resource forks. 
e Check for debug traps and debugger names in the code 
(68k code only). 
e List all version resources. 
e Remove any user defined resource types. 
You can use this last feature to quickly zap unwanted 
template or debugging resources left behind from development. 


SOFTPOLISH REPORTS 

It proved difficult to locate a single application that could 
generate a broad range of SoftPolish errors. Instead, the following 
example was created by taking the most interesting parts from 
four actual reports. I tried to include one occurrence of each of 
the most typical warnings SoftPolish generates. The preamble 
indicating which SoftPolish tests are under way was removed, and 
the name of the application is changed to protect the innocent. 
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Example SoftPolish Report 
USER INTERFACE CHECK: 


File: “Super Whizzy Write” 
Created: Thu, Mar 14, 1996, 9:01 PM 
Modified: Wed, Mar 20, 1996, 5:21 PM 
Version: 2.0.8 
ee Application BNDL signature “SpWW” does not match creator 
“CmWW” 


ALRT 900 “memory shortage” 
ee DITL 900 item 2 is within 6 pixels of the edge of the 
window 


CNTL 300 “Scroll Bar” 
ee Scroll bar should be at least 16 pixels wide 


CNTL 500 “Find Button” 
ee Button should be no more than 20 pixels tall 
Find 
¢ Space is crowded for the text; make 13 pixel(s) wider 


DITL 131 <Item #8, picture> “help” 
ee This item overlaps another dialog item 


DITL 251 <Item #2, static text> “errorl” 
Couldn’t complete the last command because error “0” 
occurred. 
ee Should this be a real apostrophe (’)? 
ee Should these be real quotation marks (“ or ”)? 


DITL 400 <Item #13, button> “Preferences” 
OK 
ee Should lower-case be used here? 
OK 
¢ Space is crowded for the text; make 11 pixel(s) wider 


DITL 414 <Item #1, button> “Rename File” 
Rename file 
ee Should the word start with a capital letter? 


MENU 1 <Item #1> “Apple” 
About Super Whizzy Write... 
e+ Should lower-case be used here? 


MENU 2 <Item #4> “File” 
ee Add Attachment... (File Menu) Command-A should be used 
only for Select All (Edit Menu) 


MENU 2 <Item #5> “File” 
¢« Warning: Get Info (File Menu) Command-I is often used 
for Italic 


PICT 4 
** Resource ID numbers in the range 0 to 127 are reserved 
for use in the System file 
¢ Warning: color picture will not display on SE or other 
older machines 


STR# 700 <Item #2> “Progress titles” 
Searching... 
ee Should use an ellipsis (..) instead of multiple periods 


RESOURCE VALIDITY CHECK: 


File: “Super Whizzy Write” 
Created: Thu, Mar 14, 1996, 9:01 PM 
Modified: Wed, Mar 20, 1996, 5:21 PM 
Version: 2.0.8 

ee Should be removed from file: 


TMPL 128 pref 
« Warning: CODE 3 resource is not referenced from the jump 
table 


es Application should have a “hfdr” -5696 resource for 
Finder Balloon Help 


1 acur resource 
aete resource 
23 ALRT resources 


— 
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1 BNDL resource 
13 cicn resources 
5 CNTL resources 
10 CODE resources 


CODE 8 “Show Help” 
¢ Warning: the CODE segment is locked 


5 CURS resources 

1 DATA resource 

1 detb resource 
28 DITL resources 
2 


STR# resources 


STR# -4033 
¢ Warning: the resSysHeap bit is set on this resource 


DITL 400 “Preferences” 
ee hdlg 400 needed by DITL 400 item 16 is missing! 


5 DLOG resources 
1 DREL resource 
2 eggs resources 


eggs 403 
*e eggs is an Apple-reserved resource type; it should be 
used only in Apple files 


SPELLING CHECK: 


File: “Super Whizzy Write” 
Created: Thu, Mar 14, 1996, 9:01 PM 
Modified: Wed, Mar 20, 1996, 5:21 PM 


MENU 2 <Item #5> “File” 
Get Info 
e* Questionable spelling: Info 


STR 300 “OS Error” 
Mac OS Error Encountered 
e+ Questionable spelling: Mac 


CLEANUP NEEDS: 


File: “Super Whizzy Write” <None (normal) > 
Created: Thu, Mar 14, 1996, 9:01 PM 
Modified: Wed, Mar 20, 1996, 5:21 PM 
Version: 2.0.8 


CODE 2 “Core Part 1” 
+ Warning: the resource may contain 7 Debug instruction(s) 
«+ Warning: the resource may contain 1 DebugStr 
instruction(s) 
« Warning: the resource may contain 8 MacsBug name(s) 


CODE 4 “Whizzy Specific” 
* Warning: the resource may contain 2 CHK instruction(s) 


vers l 
2.0.8 2.0.8 Copyright © 1992-1996 Whizzy Corp. 


vers 2 
2.0.8 2.0.8 Copyright © 1992-1996 Whizzy Corp. 


SUMMARY: 
SCAN ONLY 


Keyboard Equivalents for Menu Items: 
Add Attachment... (File Menu) 
Copy (Edit Menu) 

Delete (File Menu) 

Find (File Menu) 

Get Info (File Menu) 

Quit (File Menu) 
Preferences... (File Menu) 
Paste (Edit Menu) 

Cut (Edit Menu) 

Undo (Edit Menu) 


NSM ANOH HOA SE 


End of log. 
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No Pain...All Gain 


with 
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Add multiprocessing and 
cross-network processing 
speed to your applications 
effortiessly. 


PowerTap™ makes your 


Single 601 application the Fastest! 


PowerTap with Four 601 Multi-Processors 


Application with: 


PowerTap with 12+ Networked CPUs 


Execution Speed 


PowertTap isa robust, easy-to-use, 
lightning-fast multiprocessing library 
used by software developers to speed up 
their Macintosh applications! 


Without having to learn about 
networking, communications, or task 
scheduling algorithms, programmers can 
divide their application into tasks, submit 
them to Power? ap so that their users 
can get results FAST. 


See how PowerTap can speed up an 
application on your network today! 


www.fortner.com/PowerTap_demo 
800¢252°6479 


$299 


FORTNER 


RESEARCH LLC 

100 Carpenter Dr. * Sterling, VA 20164 
(800) 252-6479 * (703) 689-9593 FAX 
www.fortner.com * info@fortner.com 
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A FEW PROBLEMS 

Even though SoftPolish is a wonderful tool, it is not without 
flaws. Since reports can be long and difficult to follow, I would 
like to see Bare Bones add a logical hierarchy to the reports, with 
a set of disclosure triangles marking each level like the Finders 
list views. This way you could quickly review all problems and 
then concentrate on the areas of greatest interest. With version 
1.2 I find myself spending a lot of time scrolling through reports 
looking for particular errors. Another solution might be giving the 
user greater control over report formatting. Currently, SoftPolish 
formats all errors the same way. If the next version could mark 
different types of errors in different fonts or colors, it would make 
the reports much easier to read. 

SoftPolish would also benefit from automation. Although 
you can drag and drop items onto the SoftPolish icon, this only 
saves you from having to set the target. You still need to click 
the Scan Target button, verify the test settings, begin the scan, 
and save the results to a file. I hope the next version of 
SoftPolish supports AppleScript. 

Finally, users of Metrowerks’ PowerPlant may find 
themselves disappointed. SoftPolish does not understand “PPob” 
resources, and is therefore unable to check most interface 
elements created in PowerPlant’s Constructor. 


CONCLUSIONS 

I highly recommend SoftPolish, despite its few flaws. If you 
are looking for an effective way to improve the quality of your 
applications, you should give it serious consideration. By 
marrying a simple interface to a powerful set of features, Bare 
Bones has created a quality assurance tool from which almost 
every Mac developer can benefit. 

SoftPolish 1.2 is available directly from Bare Bones 
Software, from MacTech’s Developer Depot, and from select 
mail order sites — see Bare Bones Software’s web page 
<http://www.barebones.com> for more ordering information. The 
SoftPolish CD-ROM delivers the program’s documentation in 
PDF format, along with a few demos and freeware tools from 
Bare Bones. The CD also contains a few third party demos 
including Onyx Technology’s QC, and MindVision’s Installer 
Vise. At $99 it may not be necessary for hobbyist programmers, 
but serious shareware authors will easily recover their 
investment. If you happen to be lucky enough to program the 
Mac for a living, SoftPolish is a definite must-have. [au 


TO RECEIVE INFORMATION 
ON ANY PRODUCTS 
ADVERTISED IN THIS ISSUE, 


SEND YOUR REQUEST 
VIA INTERNET: 
CUSTSERVICE@DEVDEPOT.COM 
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WHY NOT USE THE BEST? 


Companies like Adobe, Claris, Symantec, Metrowerks, Netscape and hundreds of others 
recognize the unsurpassed quality of Developer VISE and have switched to MindVision for 
their installation needs. In fact, every day MindVision sells more installers than all other 
competitors combined. Don’t take our word for it. Ask any of our hundreds of satisfied 
customers why they switched from the competition to MindVision’s Developer VISE. 


We didn’t stop there. 
Announcing... 


INSTALLER VISE 4.0 


The New Industry Standard for Software Installers. 





Find, move, rename, or delete any file. Create hierarchical packages. Build one installer for 
multiple languages. Build installers with unparalleled ease. Attach AppleScripts to your 
installation. New archive features allow you to build CD-ROM installers quickly and easily. 

It may not slice and dice, but in addition to installing it also removes. And much, much more. 


And Introducing... 


UPDATER VISE I.! 


The Most Advanced Updater Available. 


Updater VISE is the only product that can update multiple versions of your 68K, PowerPC, 
and Fat application from ONE updater. Updaters are extremely compact and totally secure, 
allowing for easy online distribution. And, combined with Installer VISE you can update any 
number of different files giving you a total software delivery solution. 





Maybe it’s time to stop and take a look at MindVision’s software delivery solutions. 
Visit our web site for full information, 
including fully-functional demos. 


www. mindvision.com 


Email: info@mindvision.com ® Voice: (402) 477-3269 © Fax: (402) 477-1395 





s 
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SYSTEM 





MindVision 
Software 





© 1996 MindVision Software. All Rights Reserved. Developer VISE, Installer VISE, and Updater VISE are trademarks of MindVision Software. 





PROGRAMNMIMNER’S 
CHALLENGE 





by Bob Boonstra 








TANGRAMS 

The Challenge this month is to write code that will solve a 
tangram puzzle — that is, reassemble a two-dimensional shape 
that has been cut into a number of smaller shapes. The classic 
tangram consists of five right triangles of three different sizes, a 
square, and a rhomboid that are to be reassembled into a larger 
square. Your code will have to deal with a more general set of 
polygons. The prototype for the code you should write is: 


#tdefine kMaxVertices 10 


typedef struct MyVertex { 
float h;/* horizontal coordinate of vertex */ 
float v;/* vertical coordinate of vertex */ 

} MyVertex; 


typedef struct MyPolygon { 
long numVertices; /* number of vertices in polygon */ 
MyVertex vertex[kMaxVertices]; /* vertex coordinates */ 

} MyPolygon; 


typedef struct MyTransform { 
float flipH;  /* optionally flip polygon about this horiz coordinate */ 
float rotateClockwise; /* then rotate polygon clockwise by this many 
radians */ 
/* around the point with this horiz coordinate */ 
/* and with this vertical coordinate */ 
/* then translate horizontally by this amount */ 
/* then translate vertically by this amount */ 
/* only perform flip if this is TRUE */ 


float rotateCenterH; 
float rotateCenterV; 
float. translated: 
float translateV; 
Boolean doFilp; 








} MyTransform; 

void SolveTangram( 
MyPolygon *theShape, /* shape to be reassembled */ 
long numHoles, /* shape has this many holes (>=0) */ 
MyPolygon *theHoles[], /* pointers to polygons that form the holes */ 
long numPieces, /* number of pieces to reassemble */ 
MyPolygon *thePieces[] , /* shape and position of pieces to reassemble */ 


MyTransform*theXForms[] /* reassembly transforms corresponding to 
thePieces */ 


The shape to be reassembled is a polygon pointed to by 
theShape, except that the reassembled shape may have some 
holes in it. The number of holes, which might be zero, is 


provided by numHoles, and the shape of the i-th hole is a 
polygon pointed to by theHoles[i]. You are to reassemble 
theShape using numPieces polygons pointed to by thePieces|]. 
For each piece, you should transform it to its correct position by 
optionally flipping it about a vertical axis, rotating it, and 
translating it, in that order. For the j-th piece, you should store 
the required transformation in the structure pointed to by 
theXFormsjj]. Set doFilp to FALSE if no flip is needed, otherwise 
set doFilp to TRUE to flip the horizontal coordinates about the 
vertical axis with horizontal coordinate flipH. Set rotateClockwise 
to the number of radians that the piece should be rotated about 
the point (rotateCenterH, rotateCenterV). Finally, set translateH 
and translateV to the amount that the piece should be moved in 
the horizontal and vertical directions, respectively. 

Calculations should be accurate to .00001, meaning that 
when I apply your transformations using the sin() and cos() 
library functions, the resulting positions should agree with 
theShape to within that accuracy. 

All of the polygons will be legal polygons — no edge 
formed by a pair of adjacent vertices will intersect any other edge 
in the same polygon except at a vertex. The last vertex in each 
polygon connects to the first vertex (i.e., a square will have four 
vertices, not a fifth that is the same as the first). All of theHoles in 
the shape to be reassembled will be strictly inside theShape, not 
intersecting the edges. No hole will intersect any other hole. You 
may allocate up to 10MB of memory for your own use, provided 
you deallocate any allocated memory prior to returning. 

This will be a native PowerPC Challenge, using the latest 
CodeWarrior environment. Solutions may be coded in C, C++, 
or Pascal. The winner will be the solution that solves my set of 
test tangrams in the shortest amount of time. And thanks go out 
to Ernst Munter for suggesting this Challenge — he wins two 
contest points for the suggestion. 


THE RULES 


Here’s how it works: Each month we present a new programming 
challenge. First, write some code that solves the challenge. Second, optimize 
your code (a lot). Then, submit your solution to MacTech Magazine. We 
choose a winner based on code correctness, speed, size, and elegance (in that 
order of importance) as well as the submission date. In the event of multiple 
equally desirable solutions, we'll choose one winner (with honorable mention, 
but no prize, given to the runner up). The prize for each month’s best solution 
is a $100 credit for Developer Depot™ and a limited-edition “The Winner! 
MacTech Programmers Challenge” T-shirt (not available in stores anywhere). 

Unless stated otherwise in the problem statement, the following rules 
apply: All solutions must be in ANSI compatible C or C++, or in Pascal. We 
disqualify entries with any assembly in them (except for challenges specifically 
stating otherwise). You may call any Macintosh Toolbox routine (e.g., it 
doesn’t matter if you use NewPtr instead of malloc). We compile all entries 
into native PowerPC code with compiler options set to enable all available 
speed optimizations. The development environment to be used for selecting 
the winner will be stated in the problem. Limit your code to 60 characters 


per line or compress and binhex the solution; this helps with e-mail gateways 
and page layout. 

We publish the solution and winners for each month’s Programmer's 
Challenge three months later. All submissions must be received by the 1st day 
of the month printed on the front cover of this issue. 

You can get a head start on the Challenge by reading the Programmer's 
Challenge mailing list. It will be posted to the list on or before the 12th of the 
preceding month. To join, send an email to listserve@listmail-xplain.com with 
the message “subscribe challenge-A”. 

Mark solutions “Attn: Programmer’s Challenge Solution” and send it by e- 
mail to one of the Programmer’s Challenge addresses in the “How to 
Communicate With Us” section on page 2 of this issue. Include the solution, 
all related files, and your contact info. 

MacTech Magazine reserves the right to publish any solution entered in 
the Programmer’s Challenge. Authors grant MacTech Magazine the exclusive 
right to publish entries without limitation upon submission of each entry. 
Authors retain copyrights for the code. 
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Best of tntermect 


e 111 MacSource 


This is the collection 

you've been waiting 

for! Whether you are 

just beginning to learn 

«| about programming 

the Macintosh or have 

been doing it for years, 

this disc has something for you. With more 

than 630 MB of information, MacSource II 

contains everything you need to get the 

most out of your Macintosh programming 

skills - maybe even create the next killer 
application! 


The Info-Mac archive is 

the largest collection of 

Macintosh shareware 

Blais Z and freeware on the 

4 pofer cane vas | Internet, or indeed 

$39." 2c0s rs en ae 

y giga- 

bytes of some of the best programs avail- 

able for the Macintosh. Three to four times 

a year we release the latest programs, cata- 

loged and indexed so that they can be 
searched quickly and easily. 


Best of Internet 


MkLinux 


MkLinux is the Linux 
operating system that 
crcs| lets you run a free Unix 
“| on a PowerPC! It runs on 
«| the 6100, 7100 and 
$1 9.» 8100 Power Macintoshes 
as well as the Power 
Computing 100 and 120. This DR2 release has 
incorporated numerous bug fixes and 
improvements over DR1. 


X-Windows comes preinstalled with this 
release. Serial |/O and PPP support is included, 


ai= Applets contains Java™ applets with 
“| Classes and many have sources com- 
..{ plete with examples. This CD also 

= {has Java stand-alone applications, 
“:...) tools such as Java Development Kits, 
= a Java to C translator, Java compilers, 
and tutorials for Java programmers. 


SOURCE CODE 2.7 


Dev. Source Code and other Win, DOS, Linux, and Unix titles are available. 


Pacific HiTech 

3855 South 500 West Suite M Email: 
Salt Lake City, Utah 84115 

Tel: (801) 261-1024 


Orders: orders@pht.com 
Tech Support: tech@pht.com 
WWW: hetp://www.pht.com/ 





Two MonTHs AGO WINNER 

Congratulations to... Well, that is what you would normally 
read in this part of the column. Alas, the realities of publication 
deadlines have forced us to make a change in when we publish 
the winning solution. Perhaps an example of the publishing 
schedule for this, the December issue which ships in mid- 
November, would help me explain. Most of the articles for this 
issue were due to the editorial staff on September 23. Now, if 
that seems like a lot of lead time to you, it does to me also. 
However, people who know a lot more about publishing than I 
do assure me that This Is The Way It Is (e.g., most monthlies 
have 4-6 month lead times). I believe them — what does a 
software guy know about publishing deadlines anyway? 

Well, I know enough simple arithmetic to realize that it is 
difficult to include a solution submitted on October 1 in an 
article due on September 23. The publishers, being just as good 
at arithmetic, also figured this out, so they have always given 
me a little extra time to write the Challenge column. That 
presented the magazine with a Challenge of its own, in that the 
Challenge column is very unpredictable in length, making 
magazine layout difficult. 

We always try to guess how long the column is going to be, 
but that means guessing how long the winning solutions are 
going to be. Sometimes the solutions do not cooperate by being 
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aaa The NASA Engineering Source Code 
NASA disc is the first public release of a col- 
-~|lection of programs from the 
National Aeronautics and Space 
Administration. It represents years of 

95 scientific and programming effort by 
$29. some of the best engineering minds 

in the country. Many of the pro- Umich 

grams come with source code. 


Information: info@pht.com (auto reply) 


as well as AppleTalk, System V shared memo- 
ry and ANSI color. Large memory configura- 
tions of up to 100 MB are also supported. 


Additional Macintosh titles available: 


Top 10 Pick for Mac (10CcDs) $49.95 
PowerMac 2 $29.95 
3D Games Toolkit $29.95 
$29.95 
$29.95 
$29.95 
$29.95 
$29.95 
$29.95 
$19.95 


Order Now! 1-800-765-8369 | 


MacGames 1 
MacGames 2 
MacGames 3 
MacScholar Sr. 
MacScholar Jr. 
HyperStacks 








predictable in length. The Challenge deadlines (mine, not 
yours) kept creeping toward the Ist-of-the-month solution 
submission deadline. Sometimes there was only one day to 
compile the solutions, score them, select the winner, and write 
the column. Sometimes that one day was a day when that Real 
Job got in the way. (That’s right kids, you can’t make a living 
writing the Programmer’s Challenge column.) Soooo, in 
undeniable recognition of publishing reality and our continued 
goal of improving the magazine, we have reluctantly decided 
that we need to publish the winning solution three months 
after we publish the puzzle, instead of two. That is why you 
are reading this explanation instead of a description of the 
winning solution to the DNA Match Challenge. 

Seriously though, this change will provide me with a 
more reasonable amount of time to analyze submitted 
solutions and hopefully point out more interesting and useful 
features of competitive solutions. For Challenge contestants, 
we will be announcing the identity of the winner on the 
CHALLENGE email list at approximately the time that we 
would have published under the previous arrangement. We 
hope that this change, in addition to restoring some sanity to 
the publishing schedule, will allow us to produce a more 
informative and interesting column. See you next month. ff 
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By Andy Dent, Perth, Western Australia 


Customizing AppMaker 2.0 


Making AppMaker add 
button sounds to PowerPlant 


A MIXED BaG oF TOOLS 
AppMaker is an interface design and code 
generation tool by Bowers Development. It is 
incredibly flexible and has a reputation for 
generating clear code. Many people have 
learned to program the Mac from studying 
AppMaker-generated code. 

The new version of AppMaker has 
changed radically and you can look forward 
to a comprehensive review when 2.0 finally 
arrives. However, 2.0b4 is already an 
extremely usable beta. This article shows part 
of how a real world problem was solved 
with a mixture of AppMaker and PowerPlant. 
The main idea is to taste the essence of 
AppMaker — its ease of extension when you 
need a little bit more. 

Our project was to simulate an 
interface with pictures, invisible buttons 
and sounds when the buttons were 
clicked. The simulation had to be 
compiled as a Macintosh executable for 
shipping to clients. 

It was easy to draw up the interface 
in AppMaker and place the buttons, but 
AppMaker currently lacks support for 
attached sounds. Because our prototype 
was changing frequently, it was not 
feasible to repeatedly re-apply changes to 


the generated code. So we decided to extend AppMaker to 
include sounds on buttons. This required changes to AppMaker 
and writing some additional code: 


e Change the AppMaker interface to allow us to type in the 
name of a ‘snd’ resource for a button. 

e Change the AppMaker definition of a window item, to store 
the ‘snd’ name. 

e Add logic to the code generation to allow calling the sounds. 

e Add PowerPlant classes to play the sounds and attach them 
to the buttons. 


A BrikEF History OF APPMAKER V2 

Version 2 is a complete rewrite from 1.5 and looks very 
different. It underwent a redesign for portability, customisability, 
and extensibility. This included removing the need to choose 
your target environment up-front, making it purely a generation- 
time decision. 

The new design was implemented with Component 
Workshop in 1993 and 1994. The first version (AppMaker 2.0b1) 
had major speed problems and was almost unusable. (Anyone 
remember Component Workshop, the interpretive Dylan-like 
environment for C++ that showed so much promise?) 

In late 1994 Bowers started converting to real C++ and 
PowerPlant and had that running in mid 1995. The first 
PowerPlant version (2.0b2) was rather unstable but around 5 
times faster. Versions 2.0b3 and 2.0b4 have improved since in 
features and stability, and Bowers Development anticipates 
completion in mid 1996. 

Version 2.0b4 adds many crucial layout editing features 
such as alignment, nudging with arrow keys, etc. Support for 
Jim’s CDEF’s was also added; these gave very usable tabbed 
dialog controls. It is almost feature-complete, with very little left 
to do other than fine-tuning some of the interface. 


Andy Dent has a passion for user-interface design, application frameworks and object-oriented development tools. This 
makes him a great (constructive) critic of AppMaker. He lives mainly in CyberSpace at CompuServe 100033,3241, 
dent@highway1.com.au and <http://www.highway1.com.au/adsoftware/>. 
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only $89* 


*Free with 
purchase of 
Tools Plus 
Developer Kit 


World-Class Controls 
for the Discerning Developer 


For all Macintoshes and system versions 
Full color and multi-monitor support 
680x0, PowerMac and Fat/Safe format 


The finishing touch for a complete 3D look 


V 7 buttons, 9 tabs and 11 sliders (flat/3D text, 
flat/3D body, raised/inset title, soft/bold shadows, 
variable shapes) plus a thermometer 


V Customizable check boxes plus undefined state 
VY Sliders options: tick marks (1 side/2 sides/none), 


scale (forward/reversed/none), snap or step to 
mouse, smart scaling 





The following example is from a Quadra 700, which is no 
speed demon. 





Build of “PowerPlant.AMMake” 
(press Command-Period to cancel) 
Creating PowerPlant 
Compiling resource templates: 
:Resources:Main 
Resources :Menus 
:Resources: Windows 
:Resources:Styles 
Compiling source templates: 
:Sources:GenWhat 
>sources:Main 
:Sources: Window 
:Sources:Dialog 
file “:Sources:Dialog”; line 279 
// only string or int (not ‘ref?) permitted in a NameStatement 
file “:Sources:Dialog”; line 279 
// Assignment, Call, or NameStatement expected 
Error(s) encountered-compilation aborted 
4797 lines compiled in 49 seconds 
Rate = 5873 lines/min 
Saving PowerPlant..done 





APPMAKER CHANGES AND CODE WRITTEN 
Changes to AppMaker 

The changes can be summarized as adding a data member 
and an interface to set the data. 

In the AM Prefs file, a Property was added to contain the 
name of the sound. This was simply a matter of selecting the 
Window Item category and choosing Edit - Add Item to add 
another to its list of Property Defs such as Item Kind, Command, 
etc. Think of this first part like changing a C++ class definition. 
Filling in the objects in your document is like using the classes 
in a C++ program. 





hStickiness 
Has vScrol] 
Has hScrall 


Figure 1. The Prefs browser unwound enough to see Window Item. 


When you add an item to an AppMaker definition, it is one 
of a number of base data types. You can refer to complex data 
types by creating a new category for them and using a 
Reference. For this version of sounds, I used just a simple String 
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to record the sound name. A later version would rely on 
AppMaker being extended to contain ‘snd ’ resources. In that 
case, a Reference to the Sound category would be used. This is 
the only area of extension which requires Bowers Development 
to assist — they have to build in storage for the binary resource 
types, and functions to handle their input (via pasting) and 
output (in generated resource files). 


we @ String 
P| integer 
Boolean 


Reference 
Graphic 

List of String 
List of Integer 
List of Boolean 
List of Reference 
List of Graphic 





Figure 2. Adding the SoundName item as a String. 


After adding the data storage for sounds, I needed an 
interface to specify them. Note that AppMaker doesn’t force you 
to take this step. For any object in your document, you can 
always access a properties list which shows every possible 
property. However, I wanted the default Info dialog to display 
my sound name. This would let me double-click the button and 
see the sound with the other few crucial properties. 

This interface customizing is one of the great strengths of 
AppMaker. When designing, you see only a few properties for 
each item on the screen. However, if you add something or decide 
that other properties should be easily accessible, it is only a few 
minutes work to redefine the interface to show those properties. 

You edit the AM Interface similarly to editing your own 
projects. The only difference is, when you double-click an item 
in the AM Interface screen, you see a dialog letting you set its 
target property, such as Sound Name. 


‘+ Menu Bars 


vy windows — 


S Flavor: Standard ¥ 
Sound Name:[Cick 








Figure 3. The Sound Demo project with the Play button double- 
clicked, showing the final version of the Button Info dialog with 
the new Sound Name field. 
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tool for busy software development teams: 


Automate TestTrack automates the 
tedious and error-prone process of 
reporting and tracking bugs by hand. It 
also eliminates the need to create a 
custom solution using general purpose 
database tools such as 4D™ or 
FileMaker Pro™, 


Stay up to Date TestTrack lets any 
authorized user look up the current 
state of any defect at any time. 





TestTrack is ready to use 
right out of the box— 
simply install, add a few 
users, and start tracking. 
It’s that easy. 


TestTrack is more than an easy-to-use bug tracking program—it’s a powerful quality control 


Communicate TestTrack links engineers, 
testers, managers, even tech writers together 
so no one falls out of the loop. Team 
members are notified automatically when 
defects are assigned to them, guaranteeing 
communication and ensuring efficient work 
flow. 


Analyze TestTrack makes reporting easy— 
point, click, print and read. Customize 
reports to list what you want to see. 


| For a limited time, you can buy TestTrack for the introductory price of $99! 


Volume pricing, and site licenses are also available. 


To order call 513-683-6456 


Seapine Software, Inc. 1066 Seapine Ct. Maineville, OH 45039 
sales @seapine.com z Seapine 
© Software 


Changes to the AppMaker PowerPlant Templates 

Only one file need be changed in the code generation to 
specify that a CSoundAttachment be applied to buttons that 
have Sound Names. In the iButton file, two procedures were 
changed with small additions to output extra information. 






http://www.seapine.com 





iButton changes 
procedure Button.genInitMember 
// add creation of attachment, if soundName specified 


if SoundName != “” 
tb 
mPlayButton->AddAttachment ( 
new CSoundAttachment (“Click”, msg_Click)); 
1 
end if 


procedure Button. getIncludeName 
// add include of CSoundAttachment 


Gf SoundName != “” 
includeNames.addString (“\”CSoundAttachment.h\””) 
end if 


PowerPlant classes used in the simulation 
Eric Forget’s USoundPlayer was used to provide basic 
sound-playing capabilities from the PowerPlant Contributed 
Classes archives on the Internet at 
<ftp://atlantis. metrowerks.com/pub/powerplant/Util/USoundPlayer.sit.hqx>. 
If you haven’t visited the archives, they are well worth a 
look. Point your browser at www.metrowerks.com and navigate 


down, or go straight to 
<http://www.metrowerks.com/db/powerplant/search.qry?function=form>. 
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CSoundAttachment was written for this project to provide 
an LAttachment subclass that can play sounds. It uses 
USoundPlayer. (Reuseable code off the Internet, what a 
concept!) It is shown in its entirety below, and may be useful in 
other circumstances. 





CSoundAttachment .h 
class CSoundAttachment 
public: 

CSoundAttachment (const char* inSoundName, 
MessageT inMessage = msg_AnyMessage, 
Boolean inExecuteHost = true); 
protected: 
virtual void ExecuteSelf(MessageT inMessage, void 
*76Paran)-: 
// data storage 
Str255 mSoundName; 


: public LAttachment { 








CSoundAttachment.cp 
#include “CSoundAttachment.h” 
#finclude “USoundPlayer.h” 
#include <string.h> 


// use with an entry in FinishCreateSelf, such as: 
// bPlay->AddAttachment(new CSoundAttachment(“Click”, msg_Click)); 


//Plays sound when executed 
//Suitable for use with any message 


CSoundAttachment: :CSoundAttachment ( 
const char*inSoundName, 
MessageT inMessage, 
Boolean inExecuteHost) 
: LAttachment(inMessage, inExecuteHost) 
{ 
mSoundName[0] = strlen(inSoundName) ; 
memcpy (&mSoundName[1], inSoundName, mSoundName[0]); 


void 
CSoundAttachment: :ExecuteSelf ( 
MessageT /* inMessage */, 
void* /* ioParam */) 
{ 
USoundPlayer: :PlaySound (mSoundName) ; 
} 


GETING ATTACHED TO YOUR CODE 

Attachments are used in PowerPlant to extend the behavior 
of other objects, sometimes changing their behavior (such as 
attachments that change the background of text fields). They 
are an example of uncoupling objects. The LAttachment 
interface provides a high-level abstract interface. The object to 
which they are attached knows nothing of the attachments 
other than their presence. For example, an LButton just shouts 
“hoi, you mob, I was just Clicked” and carries on in ignorance. 
If the attachments have been created to care about Click 
messages, then they will react. (Attachments typically react to 
either a// messages or one specific message, such as msg_Click.) 

One subtlety is that attachments are synchronous. Thus, the 
button is not able to carry on with its Clicked behavior until all 
the attachments have been executed. Another important point 
to note is when the attachments are called. In the case of a 
Pane, it sends the Clicked message to attachments when the 
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mouse is pressed. This means our sound is’ played when the 
user presses the button (mouse-down). Buttons inherit their 
attachable behavior from Panes. 

If you wanted the sound to play if the user activates the 
button (mouse-up inside the button) then you are out of luck 
— there is no broadcasting to attachments when a button is 
triggered. An alternative to using attachments would be to add a 
Listener to the button. Listeners listen for results (such as 
buttons being released). A good exercise would be to take 
CSoundAttachment and rewrite it as CSoundListener. 

The difference between Attachments and Listeners may 
seem confusing. One key point to remember is that Attachments 
can modify behavior — they are called before the action and 
return a Boolean value, so they can actually stop the action. 
Listeners are even more uncoupled and have no side-effect on 
the actions at all, being purely a way to react. 

For more reading on the design ideas behind attachments, 
see Design Patterns by Gamma, Helm, Johnson & Vlissides 
ISBN 0-201-63361-2. More recent work on patterns can be 
found in Pattern Languages of Program Design edited by 
James Coplien & Doug Schmidt ISBN 0-201-60734-4. In 
particular, the ValueModel pattern discussed in chapter 25 
seems relevant to our interface customizing and code 
generation work. 


Is 1r REALLY SO Easy? 

My first exploration into customizing AppMaker was adding 
our OOFILE integration classes which link database fields and 
views to editing and display panes. This involved a number of 
changes to dialogs, edit text fields and other classes. A rough 
version, including coming to terms with the templates, took a 
weekend. I’ve since written the AppMaker MFC templates, so I 
have a fair amount of template experience under my belt. 

However, small additions like the Sound Name example 
are relatively easy. If they are also of general benefit consider 
passing them on — Spec Bowers may roll them into the next 
release. The hard thing is deciding whether to make a tiny 
change now or something more generic. These Sound Name 
changes will probably be thrown away — it makes more sense 
to allow any kind of attachment to be specified and even to 
cope with a number of attachments. 

My current project is based heavily on AppMaker and we 
will be experimenting further with using attachments for 
business rules. Hopefully this is also a good strategy for the re- 
generation problem. If your user-defined code is attached rather 
than incorporated, it won’t be trodden on when you change 
your project’s interface in AppMaker. 

Have a good look at AppMaker — the demo’s are usually 
publicly available and on the CodeWarrior Reference CD’s. 
Hopefully this article will also have whet your appetite for using 
Attachments as a flexible way to program. The MacApp readers 
who stayed to the end may now smirk in the satisfaction of 
having had them for years as Adorners and Behaviors. 
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BBEdit 4.0 | 


“... IS the text editor.” 


MacUser, October 1996 THD 

The Tool of Choice The Tool of Choice 
for Web Page Designers for Software Developers 
¢ HTML key-word coloring. e Source code coloring. 
e Full suite of Drag and Drop HTML Tools. ¢ Integrated support for Symantec C++. 
e¢ HTML-aware spelling checker. e Integrated support for Metrowerks CodeWarrior. 
e Directly “Open From...” and “Save To...” FTP servers. e Unrivaled search and replace. 
e Preview with your favorite web browser. ¢ PopupFuncs™ for easy source code navigation. 
¢ Powerful interactive folder/project comparison. (now supports Java and Tex, as well as C, C++, 
e Frontier 4.0 integration, including valuable scripts Pascal, Object Pascal, Rez, FORTRAN, assembly 

to automate common web-authoring tasks. language, tcl, Perl, ScriptX, and AppleScript) 


htto://www.barebones.com 


Bare Bones Software, Inc. 





Bare Bones 
Software, Ine 


P.O. Box 1048, Bedford, MA 01730 ¢ main 617-676-0650 © fax 617-676-0651 


BBEdit is a trademark of Bare Bones Software, Inc. All other trademarks and registered trademarks are properties of their respective holders. © 1996 Bare Bones Software, Inc. 





DEVELOPMENT 
ENVIRONMENTS 





By Will Iverson, Apple Computer Inc. 








Choosing Your C/C++ IDE 








How well do the latest 
Metrowerks and Symantec 
C/C++ IDEs stand up to 


each other? 


This article compares two mainstream 
Macintosh IDEs, Metrowerks CodeWarrior 
10 (CW10) and Symantec C++ for Power 
Macintosh 8.0 Release 5 (sometimes 
referred to as SC++ 8.5). A closing section 
will look at alternative environments such 
as MPW and VIP-C, but the focus here is 
on the now “traditional” editor-project- 
debugger suite of tools made standard by 
the THINK tools. 

The goal is not to instruct the reader 
as to which tool to buy, but rather to 
illustrate the strengths and weaknesses of 
both environments. 


EDITOR 

The most striking thing about these 
two editors is not the differences, but rather 
the similarities. Even the default colors are 
nearly identical. Some subtle differences 
emerge when deeply scratching the editors, 
but the majority of the differences are 
minor interface changes. Both 
environments are scriptable and include a 
“Scripts” menu that includes several useful 
scripts (CW contains 7, SC++ contains over 
30). However, to get the most of the scripts 
some knowledge of AppleScript or Frontier 
would be quite helpful. 
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the App. Add Attachment(new LvieldAttachrent): 
the App .RunQ); 


/f Make sure asyne tasks get cleaned up. This call is VERY IMPORTANT. 
ff (Note: LOleanupTask patches ExitToShell, so things get cleaned up 
?? appropriately if you kill the application.) 


Go to class declaration of LCleanupTask 
Open browser for class LCleanupTask 
Open hierarchy for class LCleanupTask 
Go to member function declaration 


Go to declaration of LCleanupTask : :LCleanupTask() 
Go to definition of LCleanupTask : :LCleanupTask() 
Insert template for LCleanupTask : :LCleanupTask() 


i oe Go to declaration of LCleanupTask : :LCleanupTask(LCleanupTask&) 
ff Regi Insert template for LCleanupTask : :LCleanupTask(LCleanupT ask&)) 


Registed Find all implementations of LOleanupTask 


Figure 1. CodeWarrior editor. 


C App: :DoCommand 
C App: :-ForceClassReferences 


CAépp Betboc Tu pel roriDialog |. i. eee 


Reference clacges that de object 1/0 or are created only 
hy new hy name. 
REKFLRRSKEKR LES RSK SLRS KKK AKER SK ERE RFR ER EKRRRLRARES 


woeid CApp: :ForceClassReferences( void? 


{ 


xCApp: :ForceClassReferences¢ 3; 


f insert your own clazs references here 
# by calling TCL FORCE REFERENCE for each class 


? 
8 


* See «Cl App op 


x 
f 
f 
® 

Fy 


fFSFSTOMM ANE METHODS ##4%/ 


SERLRLELELE ERE RE RE REREL ESE RE RELA LE LER ESE LE LELE SESS 


Figure 2. Symantec Editor. 
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Both environments support source code highlighting, 
horizontal and vertical split panes, and “markers” allowing you 
to mark locations in your code. SC++ tends to be a bit smarter 
about coloring strings and allowing for multiple fonts, styles 
and colors, but CW is more flexible about configuring which 
words to highlight. 

A very interesting and rather curious development is the 
addition of Apple Guide support to both products. Evaluating 
the effectiveness of these Apple Guides is exceedingly difficult 
for this (somewhat jaded) writer. The step-by-step walk-through 
of such things as “how to build a C++ project” is too grating to 
bear, but the usefulness to new programmers is potentially quite 
great. I would be interested to hear of the effectiveness of these 
Apple Guides from new programmers. 

Both Find dialogs offer virtually identical functionality, 
packaged in completely different interfaces. The CW Find dialog 
supports “sets” that allow you to quickly switch between 
multiple groups of files. Metrowerks recommends creating a set 
of library export symbols to quickly figure out which library to 
import when unresolved link errors arise. They provide the 
export symbols files to search. 

This is not to say that the two environments are identical. 
Symantec features a KeyBinding utility, which allows you to re- 
map all keystrokes (such as to match the Emacs suite). 
Metrowerks allows you to edit errors in the same window in 
which the message appears. Nice for minor syntax errors. 
Metrowerks includes a toolbar, which looks whizzy in demos 
but basically just takes up screen space. Although Metrowerks 
offers the option of removing it, you then lose status messages 
during builds and links. [You can remove all the buttons by 
Command-Control-clicking each one. The toolbar then collapses 
to only the status bar. — Ed. esg.] 


BROWSERS 

As Figures 3, 4 and 5 show, the CodeWarrior browser is 
much more rich than the browser currently offered by the 
Symantec C++ environment. This is ironic, since the Symantec 
browser was available nearly a year prior to the first sluggish 
CW browser. Symantec’s browser in Café, their Java 
development environment, offers quite a bit of additional 
functionality compared to their C++ environment. Symantec 
insists that there will be a release 6 of SC++ that will bring the 
C++ browser to parity with the Café browser, although they 
were unable to specify when. 
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: vailable for use with 

x, SmalltalkAgents, Apple Media Tool 

ada! dtF is fully OpenDoc™ compatible. With its 

rect integration technology, dtF is fully contained in your 

application, there is no need for separate drivers, INITs or background 

processes. Standalone applications built with dtF are royalty-free. dtF 

is fully CD-ROMable and has modest runtime requirements, making it 

an ideal choice for Powerbook or Multimedia applications. dtF sup- 

ports cross-platform development on Windows 3.11, 95, NT and OS/2 
with an identical API across all platforms. 


tk The Relational 
Database System 


dtF Americas, Inc. 

19672 Stevens Creek Blvd., Phone: (800) DTF-1790 

Suite 128 Fax: (510) 828-8755 

Cupertino, CA 95014, USA _ Internet: dtF @interramp.com 
http://www.thetagroup.ilk.de 
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= [Cleanuptask hierarchy = 


exo) yt(=) am \ViF-lomrslare| 


WW ETelfaitet-ya) | 
|B=\V(=)[0) of =) ¢-} FIND OUT FAST | —— [< [Mac TCPEndpoint | 
WHAT'S GOING ON ag 






INMEMORY ~—_itsif ea rs 


R™ LCleanupTask(LCleanupTask&) 
: “LCleanupTask() 

CleanUp AtExitl) 

DoCleanup() 

ETSPatcht) 





uw» See memory allocation in any open heap at a glance. 

i Easily soot memory leaks. 

> Flags heap corruption when it happens. 

iw Works with source level debugger to let you find memory problems fast. 


wu Stress applications on the fly with Purge, Compact, and Zap. Figure 3. CodeWarrior graphical browser. 

i Allocate memory at will for precise stress testing. 

ww» Log heap data - easily document heap status over time. 

w No need for source code: nothing inserted in code; no patches | = 
to the system. Bases: |Linterrup 

i Works with 24-bit, 32-bit, and modern memory managers. Show: [_] 

For Macintoshes with 68020 or better. Requires System 7.0 or later. 


only $99 US 


Order now from Adianta, Inc. 
Phone: (415)781-8052 * FAX: (415)781-8053 
AppleLink:ADIANTA ¢ AOL:Adianta ¢ Internet:adianta @ aol.com 


For VISA, MC, or American Express orders by mail, fax, or Applelink, please include 
name, address, card number, expiration date, and phone number or email address. 


Also available through the MacTech Mail Order Store and APDA 
for more information contact 
Adianta, Inc. ¢ 582 Market St #911 © San Francisco, CA 94104 











LCleanupTask()} ae 1a sCleanupTaskList 
| LCleanupTask( LCleanupTask& } & sOldETSRoutine 
1 ~LCleanupTask¢) /€ sNewETSRoutine 
1G CleanUpaAtExit() fi 


















® DoCleanup 


Override to perform any task that must be performed before the app quits. 





void 
LOleanupT ask ::Dotleanun() 
{ 


For those unfamiliar with the class browser, the concept is 
simple. During a parse phase (combined into the compile for 
both environments) the project manager builds a database of 
symbols, including class table information. The environment 
presents this information in the form of a “browser,” allowing 
the user to navigate classes and their functions more easily. 
Browsers are typically more useful for C++ users than C users, 


although the CodeWarrior environment makes some gesture | cAppleévent @ || [Beavirtuaicetcrassinto RET ER 
toward C users with their “catalog” concept. | CAppleEventSender(ung gAdncestorOffsets 
: . , CAppleEventSender(uns gAncestors 
Perhaps the most interesting element of the CW CBartender | C AppleEventSender (uns gClass Info 
environment is the integration of the browser into the base j.. Goritar | [CAppleEventSender(vo replyDesc 


; HP cch S11] | Find 
editor. Certain words flagged in the browser database are . ——— |r 


automatically highlighted, and by clicking and holding the 
mouse on these words it presents the user with a variety of 


context-sensitive menus. Options include finding the peunlie: 
TCL_DECLARE_CLASS 


Source 


|iclass CAppleEventSender TCL_AUTO_DESTRUCT_OBJECT 
ig 


CAppleEventSender¢ 3; 
CAppleEventSender(DescType eventClass, DescType eventlO, Proce 
CAppleEventSender¢DescType eventClass, DescType eventlD, const 
CAppleEventSender(DescType eventClass, DescType eventlD, const 
“CApp | eEventSender ¢ >; 


f? Ascess 


App leEvent *GetEvent¢> { return &eventDesc; } 
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Figure 5. Symantec class browser. 
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Gives you the Information to Program your Best! 


The Debugger V2 
& MacNosy 


by Steve Jasik 
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Information Control 


TY over 10 years Steve Jasik has brought 
Macintosh Developers the superior debugger. In 
addition to the software, Steve provides timely 

support to his customers. Inspect the feature list and 
see why so many developers use it. In addition to 
basic features such as stepping and breakpoints, the 
Jasik debugger has many advanced features such as 
heap display, a fast memory watch, Soft-MMU, jump 
tracing, ... to help you track down the elusive bugs 
that other debuggers won’t help you find. 


In additon, the package includes MacNosy, a global 
interactive disassembler that enables one to recover the 
source code of any Mac application or from the ROM. 

When you compare features of the different debuggers, 
note that only one has all the below features to help you get 
your job done, and only one has MacNosy to help you debug 
any program in a full system environment symbolically! 


“The Debugger” is the debugger of choice at: 
Adobe, Apple, Claris, Kodak, Metrowerks, etc. 


WliindoumRecord._©@465320 


Wi ndowRecord 
O port 

108 windowk ind 
110 visible 
111 hilited 
112 goAwayF lag 
113 spareF lag 
114 strucRgn 
118 contRagr 
122 updateRgn 


‘CGratPor t_#465320 
o 


> TRUE 
> TRUE 
: TRUE 
> TRUE 
> *Regionl4sso74 

” "Reg i onl4ss534 

“Regi onl4359Bo0 
126 windowDefProc ”* DEF funRsrc_s 76SFo 
130 dataHaridle : 2485970 te 
134 titleHandle : B4685918 = "Untitled-1" ite 
138 titleWidth Bb? BE 
140 ControlList > AIL HIE 
144 nexthindow “*HindowRecord #465278 = 
148 windowPic > AIL 
152 refCon : $00464F22 


An example of a structured data display window 
with hypertext links to substructures 





Its Features Include: 


© Source level debugging for Metrowerks & MPW compiled 
programs (C++, C, Pascal, Fortran, ...). 


® Symbolic Debugging of any Macintosh program, ROM, 
Plug-In or code resource (DRVRs, XCMDs, INITs, PDEFs..), 
ASLM & CFM Libraries, OpenDoc parts, GX Drivers, ... 


® Simultaneous Symbolic debugging of multiple “tasks” 
© Object Inspector for MacApp 3 & PowerPlant programs 
® Source level debugging of Symantec C™ projects 


© Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SQA testing, etc. 


® Fast Software Watchpoint to find clobbered variables. 


© Soft MMU (“heap centric” bounds checking) for PowerPC 
programs to find out of bounds references. 


© Jump Trace to find where a program takes a “wild jump” 


® Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking), Heap Scramble and Heap 
Check to detect errors before they become disasters 


® Structured display of data (hypertext) with user definable 
structures while debugging 


® Conditional breakpoints to filter redundant information 


© Continuous Animated Step Mode to watch your program 
execute instruction by instruction 


® Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps, - 
make it possible to ferret out the secrets of the ROM, etc. 


© "Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 


The Debugger V2 & MacNosy: $350 
Runs on all Macs. Call For Group prices or Updates. 
Visa/MC Accepted. 

Available from: Jasik, APDA or ComputerWare (800-326-0092). 


Jasik Designs + 343 Trenton Way, Menlo Park, California 94025 » (415) 322-1386 


URL: http://www.jasik.com 


e-mail: macnosy@jasik.com 








definition, inserting a template, finding (through hierarchical 
menus) member function declarations and definitions, and 
finding all implementations of the selected keyword. 


PROJECT MANAGEMENT 
What the Symantec environment lacks in browser bells, it 
makes up for in Project Management frills. Both environments 
include basics such as status, touching files, etc. Both support 
dropping files from the Finder, but the Symantec environment 
also allows dragging files out of the environment and into other 
applications, allowing for convenient drop-launching. 





Application i 
PPNetworkStarter .cp i 1336; 1017; « 
Network PowerPlant .ppob néa: 





456620 
32444 
424176 
10080 
1000 
840 
3664 


Runtime Libraries 
THINK Class Library 
Source 
oP CApp.cp 
CMain.cp 
CSaver_CMain.cpp 


main.cp 


* @¢ @¢ ¢ ¢ +¢ ¢ @ + 


References.cp 


Resources 


Bs Project Resources .rsre 


Visual Architect .rsre 
xC App.cp 





Figure 7. Symantec Project Manager. 
The Symantec environment supports “untouching” files, 


useful when you have modified a comment in a header and 
want to avoid a complete rebuild. The Symantec environment 
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supports nested folders and projects (which can be set to 
rebuild automatically) and integrated Projector source control, 
including database creation, mounting, setting, and check in 
and check out. The Symantec environment allows you to open 
a text file without a project file being open, and also allows you 
to open multiple projects. Multiple projects are especially nice 
when grabbing libraries or synchronizing with another project. 


COMPILERS 

As you can see from the numbers below, the CodeWarrior 
environment is considerably snappier than the Symantec 
environment for large builds. Part of this is no doubt due to the 
more sophisticated project management system underlying the 
Symantec environment. Such features as internal threading — 
allowing you to continue editing source files during a build, no 
doubt contributes to the build time. 


Build Speed 

Build time 

GW ticsormusbsins 12 seconds 

Symantec.......25 seconds 

Time to build and link 13 source files (a mix of C/C++) and 
five libraries on a 7500/100 (PowerPC 601), 64MB of RAM, 256K 
L2 cache, with the default memory allocations for each 
environment, on System 7.5.3 Revision 2. No optimizations, 
default precompiled MacHeaders, and default Macintosh C++ 
application project models. 


Turnaround Speed 

0) | ere ee 4 seconds 

SV MANIC a cxcxsde 4 seconds 

Time to make a single, trivial change to a source file, hit 
run, and be running the application. 


It is beyond the scope of this article to cover the quality of 
code generated by these compilers. You can pick and choose 
among the dozens of benchmarks available to determine the 
“best” results. Put another way — if I wanted to show you that 
my compiler is faster, give me a day and I'll have a dozen 
performance tests to show you why it’s the fastest, even if I had 
to go through three dozen tests to find them. 

Generally speaking, the speed and robustness of both 
compilers are quite reasonable. If you are truly obsessed with 
speed, you can check out the Motorola compiler and Apple’s 
MrC, both of which are available as drop-ins to both 
environments. If you would like to see some in depth coverage 
on the topic of Macintosh PowerPC compiler code generation, I 
strongly encourage you to check out back issues of Game 
Developer Magazine. For more information, check 
http:/www.gdmag.com/, specifically the June/July 1996 issue. 

Finally, it is worth mentioning that the CodeWarrior 
compiler supports Direct-To-SOM. Those of you interested in 
OpenDoc and component technology should pay attention to 
further developments in this arena. 
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DEBUGGING 
At first blush, the two debuggers appear quite similar. Both 
have simple VCR style controls, stack crawl displays with turn 
down triangles to view variables, and source views with marks 
to show locations at which to set breakpoints. Beyond the 
superficial comparison, differences begin to emerge. 


|_-start b this OxO2FOCB20 
|main i '-17856 
iLApplication::Run¢} inMBARid 1128 
|LApplication::MakeMenuBar() | | | |is7 maoMppleMe..: OxOZEF 7278 
[LMenuBar::LMenuBar(short) b> *macAppl..:0x1A41 7070 
> menulDP :Ox02F46050 
numMenus :24136 
> theMBAR {OxO2F55D28 





sMenuBar = this; 
mMenuListHead = nil; 
ff Install each menu in the 
Inti6 #menulDP = Cintié *) *#theMBAR.mResourceH ; 
Intié numMenus = *menulDP++ ; 
for Cintié i= 1; 7 <= numMenus; ++i) { 
InstallMenu(new LMenul *menuIDP++), InstallMenu_aAtEnd) ; 





Source ¥ |< 


Figure 8. CodeWarrior Debugger. 


CodeWarrior approaches debugging from a shotgun 
perspective. Want a feature? It’s here, including memory and register 
displays, double-clicking a variable to display it in a memory 
window, a breakpoint summary window, watchpoints, MacsBug 
demds (to switch from MacsBug to the CW Debugger) and more. 


; 2??? C68k> 

> —cplusstart 

(pb —stert 

i > main 

| > CApplication: :-Runtyvoid> 

> CApplication: :Hand!leForeignExceptionst 

| > CApplication: :DoRuntvoid)> 

i bCA >: Process tEvent(void) 0x02COEB63 
i b> CSwitchb ::ProcessEvent(void> 0x02C2FE94 


if ¢gSystem. hasWNE > 
{ 


ff WaithentEvent is the preferred 
f? sal. tt handles rasltitasking 
ff ite friendly manner 


eventResult = Wai tNextEventteveryEvent, macEvent, 
gSleepTime, mouseRgn); 


of WalthextEvent is not available. 
ff Se rust use the old rnethed of 
’# sailing SysternTask are 





Figure 9. Symantec Debugger. 
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Draginstall. 2.0 


Here’s proof 


that the more things change 


A 


A 


Vv 


the more they stay the : 


New “Quick Build” option lets you build a 
complete installer in one easy step. 

New features such as locating files and folders, 
applying patches, and replacing outdated files 
allow you to build more intelligent installers. 
Improved support for installing non-archived 
files simplifies the creation of CD-ROM and 
network installers. 

PowerPC-native compression and 
decompression cuts installation time in half. 
AppleEvent and scripting support allows 
installations to be automated. 


Same price—$300 lets you distribute an unlimited 
number of installers for all of your products. 
No yearly fee, no royalties, no hidden costs. 
Same drag-and-drop interface familiar to all 
Macintosh users. 

Same reliability and robustness that developers 
worldwide have relied on since 1991. 

Same support policy—free technical support and 
low (or no) cost upgrades. 





For more information or a free demo, call 


1-800-890-9880 


or visit our Web site at 


http: //www.sauers.com/draginstall 


Ray Sauers Associates 
1187 Main Avenue, Suite 1B 
Wy Clifton, NJ 070114 USA 
Associat@s voice: 201-478-1970 


fax: 201-478-1513 
email: info@sauers.com 
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The Symantec debugger offers a much more sparse 
environment, centered largely on the “Data” view window, 
which allows a user to enter an expression and have it 
evaluated on the fly. If you have a need, the Symantec 
debugger will force you to wrestle with the Data window. The 
Symantec debugger does have a few nice touches, such as the 
ability to view the source in the same fonts and styles specified 
by the editor. Your code looks the same in both places. 

Both debuggers are separate applications, requiring the 
user to wait while they launch for the first time. Symantec has in 
development a debugger that includes many of the features of 
the CodeWarrior environment, including memory and register 
displays. It is scheduled for Release 6 of the environment. 


FRAMEWORKS 

It is beyond the scope of this article to provide an in-depth 
technical review of the two frameworks, Metrowerks’ PowerPlant 
and Symantec’s THINK Class Library. PowerPlant includes 
Constructor, a tool for generating graphical interfaces (driven 
entirely from a data perspective), and Symantec provides Visual 
Architect, a similar tool that also generates source code 
(although only for graphical interfaces — no Delphi here). 

I suggest that prospective users of either framework do 
their homework before embarking on a project. Consult the 
back of this magazine for many books on developing with 
either framework, and pick up a book on each. Skim through 
them, and decide for yourself which seems more intuitive. 


REQUESTS 
Both environments do basically the same things, with 
subtle differences in the way they operate and their feature sets. 

Here are some needed features that seemed to be logical 

evolutionary steps. 

e Better error handling. Frequently the error includes a suggestion 
on how to fix it —— why not offer a “just do it” button? 

e Smarter linkers/linker errors. If the linker gets an unresolved 
symbol error, why not offer to search the system path to find 
and suggest a library with the relevant symbol? 

¢ Better 68K/PowerPC integration. A simple button in the 
corner should allow me to flip between 68K and PowerPC 
builds from a single project file. 

e Breakpoints in the editor. 

e An “Instant” capability allowing me to type in small pieces 
of code and click an “execute” button. 

e Specifically for Metrowerks: support removing the status bar 
and bringing it back during a build. Both environments 
could and should offer graphical bars that are visible from a 
distance (like a Finder copy). 

e Collapsible code (a hierarchical outline display of loops, 
functions, and such). 

e Smarter build management — if I’ve only edited a comment 
in a header do not trigger a complete rebuild. 
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ALTERNATIVES 

One of the leading contenders for an “alternative” C 
development environment is Mainstay’s VIP-C. As you can see 
from Figure 10, the VIP-C editor offers many innovations. 
Clicking the black triangle next to the insertion point allows you 
to select from a palette of functions to embed any number of 
routines. The box on top of the source code is the function 
template guide, which allows you to easily tab through the 
parameters for a function, quite useful for functions with long 
parameter lists. The mini-windows are not merely summaries — 
this is where and how they are declared. 
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- void _copy_bits (char window_1, Rect rect_1, char window_2, Rect rect_2, PEN_MODE 
mode) 


Tupe 
; dispatch_setup©>; 
ACTIVATE_EVT 


ANY _FILE & void  copy_bi ts 


APPLE_MENU 
Rect rect_i 


Res Consts EA char wiridcaw 2 
Rect rect_2 
















sujtch Cexpression?> 
{ 

case constant: 
{ 


case_expr ; 
break. ; 










} 
default : 
{ 


dflt_expr; 
break ; 






Figure 10. VIP-C editor. 


The flowcharting feature is quite useful to ensure that the 
logical flow of a program is correct. Bugs tend to fall into 
syntax, logical, and functional categories. The compiler typically 
catches Syntax errors, and VIP-C’s error reporting is not 
significantly more powerful; although, it does help provide easy 
mechanisms for defining new variables. The interpreter catches 
functional bugs, and the flowchart provides the best stab yet at 
beginning to provide a solution for logical bugs. 


WwW (+} Dispatcher 
dispatch_setup 
—do_activate 
Macros El —do_click 
ACTIVATE_EVT _do_close 


ANY FILE —do_dialog_event 
APPLE_MENU 


BACKSP ACE —do_dialog_item 

CLOSE_EVT —do_drag 

CONTROL_EVT —do_grow 
_do_idle 


—do_item_update 
—do_key 


—do_menu 
_do_menu_update | 
—do_open_doc 
—do_print_doc 

—do_quit_appl 

—do_select_window 
—do_update 





Figure 11. VIP-C Project Manager. 
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The primary difference between VIP-C and the two 
mainstream vendors is the fundamental difference in their 
approach to a project. As you can see from Figure 11, VIP-C is 
based on the concept of routines, not files. This apparently 
minor difference abstracts from the developer the hassles of 
dealing with .c and .h files, making for a much more 
pleasurable development experience. 

Unfortunately VIP-C supports only C, not C++, and 
Mainstay has made clear their plans not to support C++ in the 
future. Those of you worried about migration paths and 
performance may be intrigued to know that VIP-C offers an 
export to CodeWarrior, including all of the source code. VIP-C 
may not be for everyone, but it provides a very enjoyable 
alternative with an easy migration path. 

There are other alternatives, the most prominent of which 
is MPW. Macintosh Programmer’s Workshop is Apple’s entry 
into the field, and it is curiously the least “Mac-like” of all of the 
environments. A command line tool at heart, MPW will appeal 
most to UNIX and DOS refugees. It is also quite useful for 
complex and sophisticated builds; something large houses 
encountering limitations in other environments should keep in 
mind. For more information on MPW, MrC, and other Apple 
favorites such as the vital ResEdit and MacsBug, check out 
http://www.devtools.apple.com/. 


CONCLUSION 

The Macintosh C/C++ market is more fertile than many 
think. Metrowerks is the current market leader, but time has 
shown that the market can be fickle. The current suites of tools 
are adequate, but leave quite a bit of room for improvement. In 
the estimation of this writer, the larger question is not the battle 
between environments, but rather between C++ and Java. I 
would be interested in hearing feedback and the experiences of 
other developers pursing all of these paths. Drop a note to 
iverson@aol.com. Wi 
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AppMaker supports most popular languages 
and frameworks. Just point and click to design your 
user interface, then let AppMaker create resources 
and generate “human, professional quality code” 
to implement your design. 


Use AppMaker as a prototyping and 
productivity tool or use it as a learning tool 
for Mac programming techniques or 
for new environments such as 
OpenDoc, Java, or PowerPlant. 


AppMaker is just $299 and includes a 
one-year subscription on CD. 
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Building Better Applications Via Asynchronous I/O 





Have you ever looked at an application 
and wondered how to make it faster? Sure, 
you can select better algorithms or rewrite 
sections in assembly language, but 
sometimes a fast processor or great 
algorithm is not enough. Many applications 
reach a limit where they can process the 
information faster than they can get it. These 
applications are said to be I/O bound. 
Improving such programs is straightforward, 
once you know something more about how 
the Macintosh reads and writes information. 

Most developers go through several 
basic stages in getting information in and 
out of their programs. In the first stage, 
they use their programming language’s 
built-in I/O commands — printf and scanf 
for C, WRITELN and READLN for Pascal. 
Soon, driven by the derision of their peers, 
a desire to manipulate something other 
than text streams, or a feeling they should 
be using the underlying operating system 
directly, they will shift over to the 
Macintosh FSWrite and FSRead routines. 

Quite a few Macintosh programmers 
spend the remainder of their careers using 
FSRead and FSWrite. Some use FSRead’s 
“newline mode” to emulate scanf or 
READIN. Others read their data in as 
needed, whether they need a single 
character or an entire structure. The wisest 
users of FSRead use buffering — they read 
the data in large blocks and process the 
information in memory. 

All of these techniques have one 
property in common — they all use 
“synchronous I/O.” A synchronous I/O 
operation makes the calling program wait 
until the operation has been completed. 
Programmers who want to get the best 
possible performance out of their 
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applications can eliminate this wait by switching to “asynchronous 
I/O” which asks the OS to transfer information at the same time 
the other code is running. There is another reason why advanced 
Macintosh programmers use asynchronous I/O — it’s the only way 
to get at some of the more advanced communications features 
such as TCP/IP and to get real-time information from users. 


A PROGRAMMER’S LOOK AT I/O 
We will take a look at the uses of synchronous and 

asynchronous I/O through a function that counts occurrences of 
the letter “A” in a text file. The simplest version of this program 
uses the C Standard I/O Library functions. 
int countChars(FSSpecPtr fsp) 

| 

// Count the number of times the letter A appears in the file 

FILE *f = NULL; 

int counter = 0; 


char currChar: 
char filename[64]; 


// Homemade PtoCstr operation which makes a copy of the string 
BlockMove((Ptr)&fsp->name[1], filename, fsp->name[0]); 
filename[fsp->name[0]] = ‘\0’; 


// Count the characters 

f = fopen(filename, “r”); 

while ((currChar = fgetc(f)) != EOF) { 

if (currChar == ‘A’) counter += 1; 

} 

fclose(f); 

return counter; 

| 

J 


While this looks like a simple program, quite a bit is going 
on behind the scenes. fgetc() does not simply read each 
character from the disk as the program requests it, but uses a 
buffering scheme instead. When buffering, the application (or 
library) reads a block of information into memory all at once, 
then returns each item from that block of memory. Without 
buffering, each read would have to position the disk’s read/write 
head to the proper location on the disk, then wait for the correct 
area of the disk to rotate into place. Thus the program would 
spend most of its time waiting for the drive hardware itself. 

Even with buffering, most Standard I/O library 
implementations are not as fast as going directly to the machine’s 
own file system. The extra bookkeeping associated with tracking 
an arbitrary number of files slows things down. We can write a 
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faster program using the “high level” File Manager calls. When we ee ee 


if (err == nokrr) { 
build our new program, we will buffer the data by reading it into buffer = (char*)NewPtr(kBufferSize) ; 
memory in large blocks, then process the information directly in 7 ene) A 
memory. The algorithm for our buffered program is as follows. charCount = kBufferSize; 
err = FSRead(refNum, &charCount, (Ptr) buffer); 
if ((err != noErr) && (err != eofErr)) break; 
e Allocate a fixed-size buffer (for best results, the size should if (charCount == 0) break; 
: currChar= buffer; 
be an even multiple of 1K so the Macintosh OS can read while (chartoun= 5 @) 1 
entire blocks off the disk) if (*currChart+ == ‘A’) countertt+; 
e Repeat: : 
e Read one buffer’s worth of data DisposePtr (buffer) ; 


} 
e Process data FSClose(refNum) : 


e Until the entire file has been read (charCount == 0 after 
FSRead) return counter: 
e Release the memory used by the buffer 
In the most extreme case, our program could read the 
And here is the source code: whole file in at once before processing it. This would reduce 
ine -conatChaxene(iedncepen Zap) the number of seek operations to an absolute minimum, at the 


( cost of allocating a huge block of memory. This is not always 
// Count the number of times the letter A appears in the file reading the file in blocks faster than readin ga few blocks at a time 
int counter = 0; : 


char *buffer, *currChar; Let’s compare some real-world timing figures for these 
tenes three routines. We ran these tests on a variety of Macintosh 
OSErr err; systems, including 680x0 and PowerPC models. The system disk 


cache was set to 32K for all tests. This article includes only the 
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results from a PowerMac 7100/66, but the other systems were 
similar. If you want to see the values for your own machine, the 
test application’s sources are available from MacTech NOW. 


file size countchars countCharsFS 
1000K 1003 ms 218 ms 
2000K 2754 ms 661 ms 
3000K 4031 ms 1076 ms 
4000K 5328 ms 1467 ms 
5000K 6608 ms 1885 ms 


Shown graphically, the advantage of going directly to the 
file system becomes even more apparent: 


standard 1/0 vs. the Fle Manager, PowerMac 7100 


& 
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Break on through the limitations of the List Manager 





StoneTable 

Row and column titles 
variable size row and columns 
move, copy, sort, hide, resize rows and columns 

edit cells in place 

validate data entry through callbacks 

set font, size, fore/back color, face, alignment per cell 
cell margins, top/bottom & left/right 

68K support for both A4 and A5 worlds 

“LDEF-like” custom drawing function 

greater than 32K data per table 

plus all List Manager functions and more 


StoneTableExtra 

drag cells in and between tables 
PICT support 

popup menus & check boxes 
draw boxes around multiple cells 
variable size grid lines 

controls in cells 


IMPROVING THE PROGRAM WITH ASYNCHRONOUS I/O 

In all of these routines the “count characters” code has to 
wait for the data to arrive from the disk before starting 
processing. We can make the code even faster by reading in the 
next buffer at the same time we are processing the current 
buffer’s contents. Reading in some data while performing other 
work is known as asynchronous I/O. 

Asynchronous I/O works on the basis of scheduling I/O 
operations. Instead of calling FSRead and waiting until the buffer 
has been filled, we will pass the system a request to fill a buffer 
and instructions on how to notify us when the request has been 
completed. The Macintosh OS puts our request into a list (known 
as a Queue) and fills the requests in the order they were made. 


Here’s how to structure our program using asynchronous I/O: 


e Allocate two buffers in memory. 

e Tell the Macintosh OS we want the first block of data to go 
into the first buffer. (This schedules the buffer for filling as 
soon as possible and returns control immediately.) 

e Tell the OS we want another block of data to go into the 
second buffer. 

e Repeat: 

e Wait until a full buffer is available, 

e Process it, and 

e Make another request for data using this buffer as the 
destination until the entire file has been processed. 

e Release the memory used by the buffers. 
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Notice that our program may have to wait for a buffer to 
finish filling, but it also gets to work for part of that time. Since 
we used to do nothing while waiting for the read to complete, 
any work we do while waiting now happens “for free.” 


CHANGING YOUR I/O MODEL 

Taking advantage of asynchronous I/O requires that you 
break away from the “high level” calls we used in the previous 
code samples. Fortunately, the operating system provides 
PBRead and PBWrite as the more flexible “low level” 
counterparts to FSRead and FSWrite. 

The PB calls don’t take their parameters in the stack like the 
FS calls. Instead, each PB call takes a pointer to a “parameter 
block” structure containing all of the required information. You 
can easily translate an FS call into a PB call by allocating a 
parameter block and filling in the appropriate fields. In fact, the 
Macintosh OS basically does this every time you use an FS call. 


CONVERTING FROM FSREAD TO PBREAD 
err = FSRead(refNum, &charCount, (Ptr)buffer) ; 


// Create a parameter block. We'll use “clear” to zero fields we don’t need for this example 
pb = (ParmBlkPtr)NewPtrClear (sizeof (ParamBlockRec) ) ; 
pb->ioParam.ioRefNum = refNum; 

pb->ioParam.ioVRefNum = vRefNum; 

// Note: Somebody has to supply the volume RefNum 
pb->ioParam.ioBuffer = (Ptr)buffer; 

pb->ioParam.ioReqCount = charCount; 

err = PBReadSync (pb) ; 

charCount = pb->ioParam.ioActCount; 

DisposePtr((Ptr) pb); 


So far it looks like a lot of extra work to use a PBRead call 
instead of an FSRead call. That is true for basic synchronous I/O, 
but the PB calls can do more. One of the better aspects of 
PBRead and PBWrite is the ability to set the positioning mode 
and offset each time. If you make a simple FSWrite call, you'll 
get the information located at the “mark” - a value which 
indicates the current position in the file. The PB calls allow you 
begin reading or writing from the file mark, at an offset relative 
to the file mark, or at an offset relative to the start of the file. In 
addition, PBWrite can perform a “read-verify” operation after 
writing data to confirm that it went out correctly. 

Our real reason for introducing the PB calls in this article is to 
use them for asynchronous I/O. We want to place a request with 
the system to get some data and learn when that request has been 
fulfilled. The parameter blocks have just the information we need 
to make this happen: the ioResult and ioCompletion fields. 

The ioResult field gives the result code of the operation — 
either 0 for “no error” or a negative value designating an 
operating system error. This field is filled in after the data has 
been transferred, which gives us one way to learn when the OS 
is finished. The File Manager places a positive value into this 
field when the request is posted. When the value changes, we 
know the transfer is finished and we can use the data. 
Hopefully to a 0, meaning “no error”, but it might also contain a 
negative error code. 
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Using what we’ve learned so far, we can improve on all of 
our FSRead-based routines. The code can run as fast as the 
“read the whole file into memory” version, but only use two 
small blocks of memory as buffers. Notice how we use a two 


entry table to hold a pair of parameter blocks. This allows us to 
fill one block while processing the other. 


int countCharsAsync(FSSpecPtr fsp) 
{ 

// Count the number of times the letter A appears in the file, reading the file one 
// character at a time 

int counter = 0; 

ParmBlkPtr pb[2], currPBPtr; 

int eurrPB = 0: 

char *butfer, *ceurrChar: 

short refNum; 

long charCount; 

OSErYr ere: 


// Allocate parameter blocks 

// Open the file 

err = FSpOpenDF(fsp, fsRdPerm, &refNum) ; 

if (err == noErr) { 

// Set up parameter blocks 

pb[0] = (ParmBlkPtr)NewPtrClear (sizeof (ParamBlockRec)); 


pb[1] = (ParmBlkPtr)NewPtrClear (sizeof (ParamBlockRec)); 
setup(pb[0], refNum, fsp->vRefNum, kBufferSize) ; 
setup(pb[1], refNum, fsp->vRefNum, kBufferSize) ; 


// Start 2 read operations going 
(void) PBReadAsync(pb[0]); 
(void) PBReadAsync(pb[1]); 
currPBPtr = -pb(0]; 
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Tor ‘(e2) | 
// Wait for the I/O operation to complete 
while (currPBPtr->ioParam.ioResult > 0) {}; 


// The data is ready, so count the characters 
buffer = currPBPtr->ioParam.ioBuffer; 
charCount = currPBPtr->ioParam.ioActCount; 
if (charCount == 0) break; 
currChar= buffer: 
while (charCount-— > 0) { 
if (*currChart+ == ‘A’) countertt; 
} 


// Put this buffer back into the reading queue 
(void) PBReadAsync(currPBPtr) ; 


// Switch to the other buffer 

currPs = 1] = currPB: 

currPBPtr = pb[currPB]; 
currPBPtr->ioParam.ioPosMode = fsAtMark; 


// Release the memory 
destroy(pb[0]); 
destroy(pb[1]); 
FSClose(refNum) ; 
return counter; 


void setup (ParmBlkPtr pb, short refNun, 
short vRefNum, long bufSize) 
{ 


pb->ioParam.ioCompletion = NULL; 
pb->ioParam.ioResult = 1; 
pb->ioParam.ioRefNum = refNum; 
pb->ioParam.ioVRefNum = vRefNum; 
pb->ioParam.ioReqCount = bufSize; 
pb->ioParam.ioBuffer = NewPtr(bufSize) ; 
pb->ioParam.ioPosMode = fsAtMark; 
pb->ioParam.ioPosOffset = 0; 

| 

J 


void destroy (ParmBlkPtr pb) 
( 


DisposePtr(pb->ioParam.ioBuffer) ; 
DisposePtr((Ptr) pb) ; 


Let’s look at the timing results for the above code. Again, 
since the PowerPC and 68K numbers follow the same pattern, 


we will show only the PowerPC numbers here. 


file size countCharsFS PBRead async 


1000K 218 ms 167 ms 
2000K 661 ms 454 ms 
3000K 1076 ms 700 ms 
4000K 1467 ms 934 ms 
5000K 1885 ms 1183 ms 
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Graphically, the timing looks like this: (Notice that we’ve 
changed scale from our previous graph so you can get a 
better look at the difference between synchronous and 
asynchronous I/O.) 


Sychronous ¥s. Asychronous 1/0, PowerMac 7100 
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While not a dramatic change, the last result is still an 
improvement over synchronous I/O. It’s hard to make this code much 
faster, but you can take advantage of the available processing time to 
add features and improve the user’s experience. 


IMPROVING THE USER’S EXPERIENCE 

All of these routines share a common drawback — they 
don’t allow any time for other programs to run. They sit in tight 
loops reading and processing information or waiting for the 
next read to complete. This is OK when writing demonstration 
code for a magazine article, but it isn’t a reasonable practice in 
“real” programs. Real applications should arrange for their I/O 
intensive routines to give time to other applications and to 
allow the user to cancel at any time. 

A well-designed application will give away time while it’s 
simply waiting for an I/O request to finish. Most applications 
could do this by calling WaitNextEvent, processing the event, 
then checking the result code of the pending operation before 
giving away any more time. The only problem is that when an 
application gives away time with WaitNextEvent, there’s no 
telling how soon control will be returned. Applications that 
need immediate notification at the end of an I/O operation must 
use completion routines. 

A completion routine is a function in the program that the 
Macintosh OS calls when a specific I/O operation ends. (The 
requesting program supplies the function pointer in the 
ioCompletion field of the parameter block.) Completion routines 
run under the same tight restrictions as any other “interrupt time” 
code including not being able to allocate or move memory nor 
being able to use the content of any relocatable block. Most 
completion routines are not guaranteed access to their 
application’s globals, and the information passed into each 
completion routine varies wildly. For these reasons, we will defer 
a thorough discussion of completion routines to another article. 

The completion routine for PBRead is especially poor, as it 
receives no parameters and the Parameter Block has been 
pulled off of the I/O queue by the time the routine is called. 
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This routine appears to have A5 set up for it so it can reach the 
application’s globals, but it can’t do much even then — only set 
a flag indicating the completion of I/O or take an existing block 
and issuing another I/O call for it. 

Besides giving away time, there is one other thing a well- 
behaved application should do, and that is allow the user to 
cancel an operation. If the user asks to cancel during a 
synchronous I/O operation, the application simply completes 
that operation and doesn’t begin another. However, if the user 
cancels during asynchronous I/O, the application has to remove 
all of the pending requests. The KilllO() call takes a file or driver 
reference number and removes all of its pending I/O requests, 





so applications can kill the pending requests then wait for the 
current operation to complete before closing the file or driver. 


CONCLUSION 

Developers need to look beyond basic I/O calls if they want to 
get maximum performance from their programs. Asynchronous I/O, 
while the most complicated way to read and write information, is 
one of the best ways to improve your application’s performance. 
These same techniques that improve the performance of File I/O 
become critical when dealing in near real-time applications such as 
TCP/IP networking or serial communications that cannot afford 
pauses in their data collection. [Mu 
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A Tightwad’s Guide to Flat File Databases 


Working with relations 


in a flat file data base engine 


By Way OF INTRODUCTION 

Ohne of the most naive, chutzpab-riddled 
tasks I ever set for myself was trying to build 
an accounts receivable program for my 
medical practice in my spare time after 
reading the Omnis 3 manual and tutorial. 
After spending a lot of time (and obviously 
not an inconsiderable sum on this program) I 
gave up, got wise and bought Tess 2.0, which 
weve used happily through to the present 
version of 4.4. It is interesting that this fiasco 
propelled me 1) to program in a language, 
rather than a database, so that I had complete 
control of the environment and 2) to think a 
bit about databases and database design. 

Programming to solve database 
problems using a general purpose computer 
language inevitably turns one’s attention to 
database engines and source code libraries 
to lighten the programming load. While the 
ads for many of these products promise all 
kinds of relational muscle, a lot of serious 
programming tasks don’t need that kind of 
horsepower. In the course of completing 
several programming tasks of interest to me, 
I've developed some techniques for using 
“less powerful” flat file database engines 
that may be of general interest. For some of 
you, this may be fairly elementary; for 
others enlightening. Please bear with me. 


TOOLS AND QUESTIONS 

When I try to solve any problem, I try to conceive the 
question as carefully as possible and then look at the tools 
available that might be useful. For the purpose of this discussion, 
let’s alter the normal thought process and start with the tools. The 
high priced libraries are expensive for several good reasons. 

These database engines are powerful. They can handle 
thousands, if not millions of records. They can do wonderfully 
fast searches. They are optimized to read and write keys and 
data as fast as the OS will permit. They do extensive error 
checking and error correction. They permit the arbitrary 
changing of record size, key size, etc. They permit the creation 
of relational tables and thus the creation of relational databases. 
Some interface with object oriented paradigms. 


DOES YOUR PROBLEM REALLY NEED A TOOL THIS POWERFUL? 

Most of us write databases that handle hundreds or thousands 
of records, not millions. Most of us write programs where very fast 
search, read, and write functions are not critical because there is a 
user sitting there who can’t type that fast. I’m old fashioned about 
error checking; I don’t feel as though I can ever turn down 
responsibility for this aspect of programming. Good planning can 
obviate the need for after-the-fact changes to database structure, 
and even better planning can allow for it. Relational tables, while 
useful, are expensive in terms of efficiency and disk space, and 
besides 1) a lot of really important information in our lives is flat in 
structure, and 2) the data can be represented and interrelated with 
a simpler scheme than a relational table. Object persistence is neat, 
and I don’t know how to write an object persistence scheme; for 
all I know maybe you can’t come close to NeoAccess or its cousins 
with what I’m going to propose. Maybe I’m way off base. 
However, nothing in my thinking precludes a database of objects 
where constructor/initializer routines reestablish object 
relationships as the objects are loaded. 


Ed Ringel is a long-standing Macintosh enthusiast. When he’s not programming or enjoying the Maine lakes and forests, he’s 
a respiratory and critical care doctor in Waterville, Maine. He can be reached at eringel@mint.net. 
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Way A FLAT FILE DATABASE LIBRARY? 

It is time inefficient, error prone, and hard to write a set of 
routines that manages keys, records, and files. While it may be 
hard to justify the cost of some of the high end products, it is 
equally hard to justify the enormous investment of time and hassle 
in writing your own set of database routines. A flat file data base 
engine is an excellent compromise between cost and features. 
This tool is reasonably efficient, and is within most programmers’ 
budgets. It supplies you with the code that is the most difficult to 
write. There will still be an investment of time and energy that will 
be necessary, but it won’t be nearly as dear as starting from 
scratch. This kind of library has three main features: 

e A scheme for record allocation, deletion, and reuse of 
deleted record file space. 

e A record indexing scheme. This is usually some sort of b- 
tree, but can be a hash table or some other indexing system. 

e Extensive error checking during record and key operations, 
and result codes that indicate 1) whether the database 
engine did what you asked it to do and 2) if there was an 
operating system I/O error. 

These basic functions can be used very successfully to 
manage relatively complex data sets. I am going to assume that 
anyone reading this article understands the basic concepts of 
record and key operations. 

I use a library called B-Tree Helper, from (m)agreeable 
software in Plymouth, Minnesota (Magreeable@aol.com). The 
current version is 2.2. This product comes as C source code. The 
function calls are straightforward. Mel Magree is delightfully old 
fashioned in that he actually includes a hard copy manual for no 
extra charge! The product can handle fixed and variable length 
records, many indices, and is very Mac-like in that a single 
physical file on disk can contain multiple index and record 
types; no separate index and record file is needed for each 
logical grouping of data (unless you wish to do so.) 

Some of the earlier incarnations of B-Tree Helper had 
some clumsy function calls and too many pointers to too many 
temporary results. The current version is very nice and well 
worth the upgrade if you are an owner of an older version. This 
product is used for the demonstration application. The source 
code provided for the demo will compile only if you supply the 
.c files to B-Tree Helper; the .h files for the library are 
provided. B-Tree Helper is a robust, good product and has met 
my needs nicely. There are other flat file engines available, but 
this article is not a product review. The reader can easily find 
and compare different products. 


INVOICING REVISITED 

To make my points, and to demonstrate some techniques, 
I would like to revisit the model problem of invoicing. This is a 
standard database problem that some of you may have 
encountered previously in examples or classes. The classical 
invoicing structure, at its simplest, contains four different types 
of records, each contained within its own file. Figure 1 shows 
the basic interrelationships of data. 
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Figure 1. 


There is a customer, a part, an invoice, and a line item. The 
customer record contains data about the customer, how much 
he/she owes, etc. The parts record contains information about 
each item being sold. The invoice is an open-ended structure 
that tells us about who the customer is, and the various items 
sold to the customer at that interaction. Each line item consists of 
the part, the number of parts sold, the price, etc. 

When there is a sale, the program would create an invoice, 
n number of line items, and relate the invoice and line items to 
pre-existing records that represented customer and part 
information. Each line item structure contains a reference to the 
part information for that line item. This can be done either 
through a relational table, or it may be done simply by 
embedding a reference to the part information in the line item. 
When a line item record is retrieved, the application is written 
so that the information about the part reference is retrieved. 

I solve this problem without a relational database. The 
customer does not need to have a direct relation to a line item; the 
invoice does that for him/her. Similarly, the customer needs no 
relation to the parts catalog. With some planning, and 
understanding of the information problem, a series of special 
indices and embedded links can be constructed that give you all 
the data interrelations that you will need. In any setting where the 
interrelationships are fixed, and the data queries are predictable 
and have been anticipated, a combination of careful programming 
and good data structures are a powerful data management system. 





Don’t SCARE YOUR CUSTOMERS — THINK AHEAD 
This kind of programming requires a lot of forethought. 
Unlike an interface, it is hard to create data structures on the fly. It 
is critical to have a clear vision of the problem and how you are 
going to solve it, because you are hard-coding data relationships. It 
will be difficult for you, and frightening for your user (yes, 
frightening) when you twiddle an existing file to “add some stuff.” 
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Why frightening? I’'ll use myself as an example. My accounts 
receivable program handles billing and payments from insurance 
companies and from patients. I literally eat and pay my bills from 
the information in this file. Tess 4.4 and its programmer(s) are great. 
However, what if this alert came up on the screen when I 
installed an upgrade? “Make sure you have three clean backup 
copies of your current data because we're going to twiddle your 
file structure and add some stuff we forgot. We’re going to 
completely tear apart your file structure and rebuild it, from 
scratch, on the fly. Don’t do this operation during a 
thunderstorm. In fact, don’t even breath near the computer for 
the next couple of hours. This will take half an hour per 
megabyte of data on a Power Mac 9500. Press OK to continue.” 
You and your users will need to live with your decisions 
for a long time. It may be worthwhile thinking more like a civil 
engineer in a litigious society than a software engineer trying to 
be elegant: overbuild, overbuild, overbuild. Talk to your end 
user(s). Know the problem before you try to solve it. Build in 
extensibility. We will see how to do that in a few paragraphs. 


INVOICE EXAMPLE AND B—TREE HELPER IN DETAIL 

My example program, which is cleverly named Invoice 
Example, and B—Tree Helper deserve some explanation. Invoice 
Example is based loosely on some sample code from DTS, 
which I used as a framework to handle three modeless dialogs, a 
couple of menus, a bunch of alerts and a single modal dialog. 
The interface is not elegant, but it gets the job done. I have 
separated the code into GUI related files and function related 
files. The user interface code is fairly pedestrian and I have no 
secret techniques; the meat of this article is in the folder called 
“functional files.” Header files for B-Tree Helper are included, 
but obviously not the source files. A compiled 68K application 
with an example data file is available for download and on the 
subscription disk. The source code and the application genuinely 
complement this article. However, some of the important 
routines are long and are not well suited to hard copy 
presentation. Please review the source code (obtained from disk 
or ‘net) or many of the points may be murky. 

To perform an operation, the user selects from a popup 
menu in the window. This sets the mode (find, next, insert, 
edit, etc.). When all of the data is ready, the user clicks the 
Do It button. In the Invoice window, two steps are required 
for insertion. First the user enters references to customer and 
parts and then clicks the Load Related button. This checks 
for valid data, does some math, and then loads the related 
records. Second, the user clicks the Do It button. Searches 
and deletions of invoices are simpler and require only a 
mode selection and a Do It click. There is a window each 
for Customer, Invoice, and Part operations. The fourth 
window is for a separate example which we will get to later. 

The program reads and writes data to a file, and then uses 
embedded information or appropriate keys and indices to recall 
related information. The precise mechanism for this is in the 
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commented sample code. We use B-Tree Helper for all file 
related functions with the exception of some resource calls. 

B-Tree Helper consists of 40 calls that create, open and 
close files, insert and delete records, insert and delete keys, do 
complex searches, manage record buffering, add and delete 
index trees, and permit retrieval of raw page data for debugging. 
To create a file, the main programming task is the initialization 
of a series of index trees, which are then passed to the creation 
routine. These trees represent your index structures. 

The other major planning task is to determine file block size 
(space in the file is allocated by blocks). The size of the block 
determines the maximum record size, because B-Tree Helper uses 
control records interspersed with your data to manage available 
file space. These control records are immovable islands in your 
data stream, and your records must fit between them. Thus, you 
must calculate your allocation block size so that your maximum 
sized data can fit between the control records. Although B—Tree 
Helper allows variable length records, you will hit a size ceiling of 
8*fileBlockSize*(fileBlockSize-8) bytes unless you split your data into 
chunks (which is not the end of the world either). Upon 
successfully creating a file, a FileControlHandle — the record that 
manages the file while open — is returned and is used in virtually 
every other call to the B—Tree Helper library. 

Interestingly, B-Tree Helper does not require formal 
definition of a record; you simply request n bytes of data from the 
file. If successful in allocating this block of file space, you are 
given a success result code and a file address. You can then write 
and subsequently read data from this address. This address is a 
four byte long and is also passed to key insertion functions. When 
a key is searched for and found, the key is returned and so is the 
file address. However, it is not required to pass a file address to 
the key. Any four byte value is legal, and this can be used very 
much to our advantage, as will be shown later. Because records 
are not defined, keys are also not irretrievably linked to a record 
type or logical file. This can also be used to our advantage. 
Finally, because a record is not specifically defined as to content 
or size, many kinds of records can coexist in a single file. Thus, I 
think of a B-Tree Helper file as a physical file enclosing any 
number of logical files, index structures, and map control records 
(Figure 2) B—-Tree Helper is very flexible in this manner. 
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Figure 2. 


REDUCE FLEXIBILITY CREATIVELY 

When I have tackled more involved problems than Invoice 
Example, I have taken the time to reduce flexibility and create 
structures that describe each index and record type. This has 
saved me an enormous amount of headache when debugging 
and writing code. 

Review of the B-Tree Helper functions shows that there is 
great similarity among the calls of a given function class; key 
related functions and record related functions all pretty much 
take the same kind of parameters. I have usually written 
parameter block structs that I then pass to a custom function that 
is a wrapper for the B-Tree Helper call. This relieves me of 
getting the parameters and degree of indirection right each time 
I call Insert_Key() or Find_Equal(). Additionally, I declare these 
parameter block structures as global or static. Just as each logical 
file in your database has an “active” or “current” record (i.e. a 
record that is loaded into memory and being operated upon), 
there is a corresponding active key and corresponding active file 
address. Although I usually separate the actual data from the 
parameter block, having current keys and current file addresses 
that can survive between function calls can be very useful, 
especially when doing successive operations upon multiple 
logical files. This is demonstrated by supporting Next and 
Previous functions in the example program. 

I am not heavily into object oriented programming, but 
writing a series of wrapper classes for B—Tree Helper seems like a 
very sensible, productive thing for you C++ buffs out there to do. 
In particular, C++’s multiple inheritance would permit creating 
complex objects that could respond to a single command to 
insert a record, a key, and then link to a related record. 


MAKING RELATIONSHIPS WORK 
Records with embedded addresses 
I have repeatedly referred to linking to related records. 
How do we do this? I use three basic techniques. 
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First embed a file address into a record. Let’s examine the 
declaration for the CustomerType struct: 


struct CustomerType{ 
unsigned char CustName[32]; 
long CustNo; 
long StringAddr; 
1. 


Jy 
typedef struct CustomerType CustomerType; 
unsigned char gCustString[40]; 
CustomerType gCustomer; 


I thought CustomerType had the information we need for 
the example; however I “forgot” to allow room for a comment. 
Luckily, I had thought ahead and had left an extra four byte 
field in CustomerType, which I then renamed StringAddr. After 
we retrieve all the information from the dialog, we Get_Bytes() 
for gCustString first, and Write_Data() from the memory address 
of gCustString to the file address returned by Get_Bytes(). We 
then set gCustomer.StringAddr to the file address returned by 
Get_Bytes() as well. Then, and only then, do we allocate space 
and write the data for the parent gCustomer record. 

When information is retrieved, we follow the reverse 
sequence. We Read_Data() and get gCustomer first. We then 
Read_Data() using the _ file address stored in 
gCustomer.StringAddr to get the child gCustString. 

I use this technique when the referenced record is truly a 
child record — it will never be looked for unto itself. This is a 
nice way of gracefully adding to a record which was 
missdeclared, and is a prime way of adding record extensibility. 
For this reason, I will generally add an extra unused four byte 
field to just about any record I declare in a “serious” program. 
This is one of the simplest ways of overbuilding your software to 
keep data integrity at a maximum. Had we used this scheme and 
needed to make an ex post facto change to an existing file, my 
update routine would have read into memory the parent record, 
allocated and wrote the child record (the new stuff), set the 
correct field of the parent record with the file address of the child 
record, and rewrote the parent record to file. No reindexing or 
reconstitution of existing data would have been necessary. 


Sequence numbers to the rescue 

This is a nice, simple system. It works well. Why limit its 
use to a strict parent/child relationship? The problem is that of 
editing or updating data. If gCustString were a record that had 
multiple links, and the file address of gCustString’s data were to 
change (which can easily happen when a record is edited or 
updated), I would need to find every record that had a link to 
the changed record and insert the new file address. There are 
two remedies to this problem.One is to create a pseudo file 
address that remains constant regardless of the true file address 
of the record, but always points to the true file address (like a 
handle). This strategy is used by DynaBase, a flat file database 
engine which is no longer commercially available. In DynaBase, 
all file addresses were pseudo addresses, adding overhead 
where none was needed. 
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The second approach is to use a sequence number; at 
allocation each record is assigned a number which is that 
record’s and only that record’s, never to change for the life of 
the file. There are a number of ways to issue sequence numbers. 
For the demo, I used a custom resource that is a handle to a 
small record whose fields are incremented whenever a record is 
allocated. This technique is shown in the example program and 
I will not dwell on it here. It is equally easy to put a sequence 
number dispatching record in the data fork; using B-Tree Helper 
to make a Get_Bytes() call for your sequence dispatching record 
and put the resulting file address into one of the .application1..4 
fields of the FileControlHandle and the address of the record will 
survive across work sessions. See the Picture Creator demo for a 
simple example of this technique. 

If we examine the declaration for the invoice struct, we see 
that the line item fields are in fact long integers: 


struct InvoiceType { 


long InvoiceNumber; 
long LinelItem1; 
long LineItem2 ; 
long CustNo; 


Is 
typedef struct InvoiceType InvoiceType; 
InvoiceType glInvoice; 

After each line item record has been filled in by the user, 
the program goes to work. A sequence number is issued to that 
line item record, and the appropriate field in the line item record 
is filled in with that sequence number. Second, that sequence 
number is inserted into field Lineltem1 or Lineltem2. Third, a key 
is inserted in an index tree, with the sequence number as the 
key pointing to the file address of the line item record. 

This second way of relating a record, that is, to embed the 
sequence number of a record into the body of a related record, 
is shown in Figure 3. 







Key 









Read into memory 


Line Item Sequence # 





Find on Seq. # 
Line Item Record 
Refresh screen, 
etc. 
Figure 3. 


When an invoice is retrieved, the invoice record is retrieved 
first. A search is performed on the sequence number in either or 
both of the two line item fields in the invoice record. The file 
address that is retrieved is the file address of the line item to be 
read into memory, and a Read_Data() is performed. 

This example is trivial, and each line item record belongs 
to one and only one invoice. Correcting the invoice record for a 
change in file address of the line item would be easy even if a 
sequence number had not been issued. However, more 
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complex data structures may have a record that links to many 
other records, and each record would have to be brought into 
memory, fixed, and rewritten to disk. That’s a lot of error prone 
work. With B-Tree Helper, there is a slick function called 
Change_Address(), which will fix the address of a key when 
there is a file address change. Even if Change_Address() did not 
exist, this is only a few lines of code. 


Indirect Index Trees 

The final way to relate records is with the use of a key 
from one record pointing to the sequence number of a related 
record (Figure 4). 
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Figure 4. 


One of the functions we have in Invoice Example is to find 
the invoices belonging to a customer. Using the name of the 
customer as the key, we insert this key pointing not to a file 
address, but to a long that is the sequence number for an invoice 
belonging to the customer — B—Tree Helper will accept any long 
for the “file address” portion of the key. We then use this retrieved 
sequence number as the key to another index where the 
sequence number key now points to a real file address. Thus, two 
key lookups must be performed for this search, but the 
relationship between the customer record and the invoice record 
will survive file address changes of the invoice nicely if just the 
second key is kept updated. This kind of relationship is very 
useful when a record may have a relation to many other relations. 

For so-called “many-to-many” relationships, a series of 
intermediary relating records, consisting of just sequence numbers 
with appropriately directed keys, can fill the bill. Implementation 
of this solution is left as an exercise for the reader, which 
translated into plain English means that you may want to rethink 
buying one of the more complete solutions if your problem is 
very hairy. Just remember though, the invoice record that we 
created is in fact the very kind of record with pointers to other 
records in other files. Maybe it isn’t as hard as you thought. 


GENERAL DATA MANAGEMENT WITH A DATABASE LIBRARY 
The last idea on the creative use of flat file database 
engines has nothing to do with databases, just plain information 
management. Although some of this discourse may be rendered 
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obsolete by OpenDoc, consider the problem of the complex 
document. Several years ago I wrote a program that did 
extensive data crunching of information on patients’ sleep. 
There were half a dozen header records of fixed length, and 7 
arrays that could vary anywhere between a couple of hundred 
and several thousand bytes a piece, depending on the severity 
of the sleep disturbance. Rather than reinvent the wheel to save 
this complex document to disk, I simply used a database 
manager. I viewed each piece of information as a variable 
length record within a logical file. I let the database do all the 
insertions, deletions, and updates for me, rather than writing 
routines from scratch. With the arrays varying so greatly in size 
(I saved the arrays as a single block, rather than element by 
element), it was much easier to use generic pre-built routines 
that handled variable length records. 

As an example of this solution, I have made a fourth dialog 
window that opens a picture of Joshua Chamberlain (one of our 
most famous Mainers) and a short text blurb about him. While 
this could have been saved as a couple of resources (and in fact 
the example file was created from resources), the picture and 
text are in the data fork of a B-Tree Helper file. This is one of 
the most intriguing uses of a database engine, particularly for 
the independent, small project programmer. 

My last point to make has to do with error checking. Do it. 
Do it a lot. My example doesn’t do it half enough. The only 
specific advice I have is to insert data first and keys second. It is 
much worse to have a key pointing to nowhere than an orphan 
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record, and it makes the cleanup procedure after a failed 
read/write much easier. 
PUNCH LINE 
To summarize, here are the salient points of this article: 

e Not every database problem needs a relational database. 

¢ Use a flexible flat file database manager as your major tool 
for data management. 

e Consider and construct your data relations very carefully. 

e Add an extra four byte field or two to your record 
declarations. They may come in handy later. 

e Consider writing custom functions around the database 
toolbox calls to improve readability, reduce errors during 
programming, and make file management easier. If working 
in an object oriented environment, consider building a series 
of good quality wrapper classes for the function/parameter 
block entities that can be reused. 

e For simple parent-child data relations, simply embed the 
address of the child in the parent record. 

e Use embedded sequence numbers for relatively simple 
relations where the child record may be moved within the file. 

e Use keys from one record pointing the sequence number of 
another record to create complex data relations. 

e Consider using database engines to manage complex 
documents. 

e Error check till you can’t stand the sight of an if (myErr != 
noErr) clause. 

May you all be spared the ignominy of my first project. 
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by Kevin Quah, Symantec Technical Support 





This monthly column, 
written by Symantec’s 


For instance: 


procedure foo (first : integer; 


d, third : 13 
Technical Support ae weer ie 
Engineers, aims to 
provide you with Q: I have lost my Cafe userid and password to the Cafe website 


to download my Symantec Cafe updates. How do I get a 


technical infe ormation new userid and password? 


based on the use of 


A: Call t t (800) 441-7234 and st a new 
Symantec products all customer service at (800) 34 and reque 


userid and password. 


Q: I am using the Think Project Manager Q: Which version of Symantec C++ is suitable for my Macintosh? 


to build a C Mac application and I 
want to be able to use SetGWorld 
with CGrafPtr or CWorldPtr as 
arguments. However, I do not want 
to have to coerce them to a CGrafPtr 
before I can call SetGWorld. 


: You can turn off pointer type 


checking (at your own peril!) so that 
your program will compile without 
the hassle of doing cumbersome 
coercions. Choose Options > Think 
C... from the Edit menu. Uncheck the 
box next to Check pointer types. 
Then find a safe place to hide this 
code so nobody notices the 
programming sin you just committed. 


: How do I make each formal parameter 


of a function or procedure appear on 
a line by itself in THINK Pascal? 


: 1. Choose Source Options... from 


the Edit menu which should bring 
up a dialog box. 

2. Click on the Parameters icon. 

3. Set the radio button next to List 
formal parameters vertically. 

The formatter will put a carriage 
return immediately after each semi- 
colon in the formal parameter list. 
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: If you have a Power Macintosh running system 7.5 or higher 


with at least 16MB of RAM and a CD ROM drive, you will 
want to use Symantec C++ for Power Macintosh (version 8 
release 5, available in CD ROM format only). 

The Symantec Project Manager (SPM) is the heart of this 
integrated development environment (IDE). The SPM is a 
“fat” application, meaning that it incorporates both PowerPC 
and 68K code in a single file allowing you to optimally run 
this application on a PowerPC or 68K Macintosh. On a 68K 
Mac you will need a CD ROM drive, at least 1OMB RAM, 
68030 CPU or higher, and system 7.5 or higher. You can 
develop both PowerPC and 68K applications using the SPM, 
but you will need a Power Macintosh to actually run any 
PowerPC application that you create. You can also merge 
your PowerPC and 68K code to form a “fat” application. 
Symantec C++ for 68K Macintosh (version 7) will run on any 
68K or Power Macintosh with at least SMB of RAM, System 
7.0 or later. This development system allows you to create 
68K applications only. 


: | get a No FPU Installed error when I run my program. How 


can I fix this? 


: There are many reasons for this error. If you are using the 


Think Project Manager on a Macintosh that does not have an 
FPU (Floating Point Processor), be sure to turn off the 
Generate 68881 instructions in the Think C and Symantec 
C++ compiler options before you compile and run your 
program so that 68881 floating point processor instructions 
will not be generated. 

A more likely reason for this error is that your program is 
executing data or garbage rather than legal instructions. FPU 
instructions start with an F hex value. The program could be 
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executing in an area of memory that contains data or random 
garbage and encountered a word starting with an F hex value. 
Common programming mistakes that result in the No FPU 
Installed error include: 


1. Disposing memory that was not allocated. 

2. Exceeding allocated array bounds. 

3. Using DisposeHandle() on a resource handle, use 
ReleaseResource() instead. 


For a more complete discussion on how No FPU Installed 
errors come about, please refer to the original 
AppleDevelopers’ Technote on 

http://www. info.apple.com/dev/technotes/Main.html. 


: In Visual Cafe, I create a button or other object. After it is 
created I am unable to resize it or move it. Can you tell 
me why? 


: In Visual Cafe the Applet’s Layout Manager defaults to 
FlowLayout. In order to change this, click in the contents of 
the Applet’s window. You will see the Property List window 
change to Appletl. Next to the data member Layout 
Manager you will see that it is set to FlowLayout. Click on 
the popup menu and choose None. Then you will be able 
to resize and move your objects. 


: I have created a series of radio buttons using Visual Cafe. 
How do I set them to belong to different groups? 


: Let us say that you have created 5 radio buttons. The first 
three you name: 25-35, 35-45, 45-55. The last two you 
name: Male, Female. Select the radio button: 25-35. In the 
Property List window you will see that the data member 
GroupName defaults to Group1. In this case, select the 
name and type: AgeGroup. Do the same for the other two 
buttons in this group. Now select the button: Male. In the 
Property List window change the name to GenderGroup. 
Do the same for the button: Female. Visual Cafe will 
generate the code in real time to put the radio buttons in 
their respective groups. 


: 1 am using the Symantec Project Manager and while 
compiling my project, I got this error: Precompiled header 
does not match: RTTI settings different. How do I fix this? 


: The RTTI (Runtime Type Identification) language settings of 
this project does not match that of the precompiled header. 
If you want the RTTI settings of this project to match the 
precompiled header, this is what you do: 

1. Go to the Project menu and choose Options... 

2. Click on the PowerPC C++ icon. 

3. Choose Language Settings in the popup menu. 

4. Set the checkbox next to Run-time Type Identification. 
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Macintoshe Digitool | 
Common : 
Lisp 


An Object-oriented Dynamic Language 


Now PowerPC Native! 


For the full story visit our Web site: 
http://www.digitool.com/mcl5.html 


Netscape: Digitool, Inc. Home Page 


Digitool, Inc. 


Welcome and thank you for stopping by. 


. Our expertise is Macintosh and Common Lisp development. Our main productis MCL (Macintosh 
Common Lisp). Digitool was formed over a year ago to acquire MCL from Apple Computer and to 
bring you a PowerPC native implementation. Most recently, we have also been contracted by Apple 
port the Apple Ervlan Technology Release to MCL for the PowerPC. Our development effort is 

spamsored by a runber of MCL customers and our group includes key members of the Apple saul Coral MOL 
development eens. 


If you just happened here, then you've stumbled across the MCL Phenomenon, one of the best kept secrets 
in Macintosh development. 


News Flash! 


December 15, 1995. Digitool, Inc. to port Apple's Dylan Technology Release to PowerPC MCL! Check 
out the full txt of the snocommernent. 


Check out the earlier news flashes! 


: My code compiles and runs fine by itself, but if I run it with 


the Symantec Debugger and set a break point, it crashes 
when it hits it. Any ideas? 


: Try resetting the Debugging information for your project by 


holding down the Option key as the Debugger is loading 
(right after selecting Run with Debugger). 

You might also try trashing the Symantec Debugger preference 
file in the Preferences folder in your System Folder. 


: I just started using Visual Architect from Symantec C++ v8r5 


to create a simple Mac Application. The Application compiles 
OK, but when I go to run it, I get a link error: Undefined 
Symbol: main (PPCRuntime.o). What am I doing wrong? 


: Until the actual code gets generated by VA there is no main 


block in your project. The Project will still compile as you 
found, because the TCL sources are all perfectly happy by 
themselves, but without the generated code containing 
main(){} the linker will complain because your application 
has no entry point. 

You need to go back into VA and select Generate All. Then 
recompile and run again. All will be well. 


Special Thanks to Mark Baldwin, Rick Hartmann, Steve 


Howard, Noah Lieberman, and Scott Morison for their 


contributions to this article. 
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By Roger Smith 


PowerPc 





Leave the Data (Fork) Alone! 





A developer utility to 
restructure fat/PowerPC 
applications 


WARNING! 

This article may change your life forever. 
Okay, maybe that’s a bit dramatic, but 
hopefully by the time you finish reading 
it, you will have discarded all previous 
knowledge on how to structure fat 
binaries. The utility MoveData that we will 
examine shortly, grew out of a need to 
create a fat application which stored data 
in its data fork. It turns out that the 
default model of native applications 
storing code in the data fork, is merely a 
default. Apple designed the Power 
Macintosh runtime architecture with 
sufficient flexibility to allow you to locate 
code fragments just about anywhere you 
could imagine. Bottom line, MoveData 
might actually save you significant 
amounts of development effort! 


OUTLINE 

There is a certain category of 
applications that allow a user to create self- 
running and self-contained documents. For 
example, a graphic artist might use a 
multimedia presentation program to create 
an informative self-running presentation to 
give to end users without the full package. 
A file compression program might create an 
archive that when run, automatically un- 
archives its contents to fill your hard drive. 


In addition to these documents being self-running, where 
appropriate, it should also be possible to re-open, edit and re- 
save them with a minimal amount of hassle. How many times 
have you just peeked inside a self-extracting archive and 
manually extracted 1 or 2 files without un-archiving the entire 
contents? It would be great if these self-running documents ran 
native on 68K and PPC machines. 

Most applications create documents where the stored 
information is in the data fork of the files. These applications 
generally use a subset of the File Manager routines for 
manipulating this data. Under the 68K model, this approach 
lends itself easily to design a self-running document. In this 
instance, a stripped down version of your application checks on 
startup to see if its data fork is empty. If it is not [empty] it 
assumes that it is a self running document and proceeds to load 
and handle the data in the data fork. The function 
checkforSelfContained() (see Listing 4) shows how to do this, 
making use of some Process Manager routines to obtain an 
FSSpec for the current application. It then uses this FSSpec as a 
basis for the subsequent calls to the File Manager to open and 
process the “Data” in the data fork of the application. 


Developing on Power Macintosh. 

The above approach breaks under the default PowerPC 
model since the application would ultimately try to load itself as 
data, (recall that by default the code for a PowerPC application 
resides in the data fork). If your application were attempting to 
interpret sound data, it could lead to some rather interesting 
“industrial” music. The exercise of creating a top musical hit 
using this approach is left as an exercise to the readers. (Hint: 
start with a Microsoft application!) What is a developer 
supposed to do? 


CFRG RESOURCE 
Apple defined ‘cfrg’ resource (code fragment), which was 
introduced with the Power Macintosh, as the key to 
understanding the MoveData utility. Using ResEdit to edit this 


Roger Smith was the lead Macintosh Developer at Gold Disk Inc. Located just outside of Toronto, Canada, Gold Disk 
developed and marketed the award winning Astound and Video Director products for Macintosh and Windows platforms. He 
has since migrated to a warmer climate working for a really large computer company in Cupertino California. 
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resource is tedious at best, as you will have to roll your own 
template to handle a resource that contains fields that vary in E == ty D : — 


size. Using Resorcerer™ makes editing and changing this Ul 
; This filter adjusts the 
resource a simple task. Sieved 6 
Reserved 
Yersion 
Reserved 
Reserved 
Reserved 
Reserved 
Fragments 1 
Architecture type Power PC="pwpc’ 
[¥) Update level Full library or application=0 
Current version $00000000 
Old version $00000000 
[¥) Application stack size $00010000 
Application subfolder alias (‘alis’} ID} None=0 
Usage Application=1 
[¥] Where does fragment start On disk, flat (data fork)=1 


MoveData 


Re eo SU Beaene SUR OSE CHORUS C Ra pead 
ees : 


Offset in data fork to fragment  Beginning=0 
Length ‘Whole fork=0 


Reserved O 

Reserved O 

Number of bytes in entire table entry (post-processed) 
Fragment (or application) name “MoveData” 
Align 


CAE MEM ISAT OEP EURO RGR TAIL OL CER ONM SAE SE UD EREMIND EOL OE CPA REME SEL ILPEROMIE SESE OIE RERIA PS OL OEP OREM AT STY PED ERDM INST SE SEO RERDATE SESE PER SM MTSE OTE PEON IL ELEC EMER MEATS SEOE 


Ss eeeanescanasessennae 





Figure 1. Application resource list in Resourcer. 





Open the ‘cfrg’ editor by double clicking on the ‘cfrg’ resource. 
Figure 2. The ‘cfrg’ resource editor in Resourcer. 


The fastest, cost effective way to get product off your shelves. 
For information: ® Voice: 805/494-9797 © Fax: 805/494-9798 © E-mail: marketing@devdepot.com 
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Normally the various fields are filled in at link time, and you 
need not worry about them. The two fields that form the heart 
of the MoveData utility are the usage field and where does 
fragment start. I have defined a C structure called codeFragRecord 
(located in the file DSGlobals.h) that mirrors this layout. 





codeFragRecord 
Listing 1. Structure definition to mimic the ‘cfrg’ layout illustrated in Figure 2. 
typedef struct fragDescriptors 
{ 

long CodeType; 

long UpdateLevel; 

long CurrentVersion; 

long OldestDefVersion; 

long AppStackSize; 

short AppLibDirectory; 

Byte TypeOfFrag; 

Byte LocationOfFrag; 

long OffsetToFrag; 

long LengthOfFrag; 

long Reserved; 

long Reserved2; 

Str255 Fragname; 
}fragDescriptors; 


typedef struct fragDescriptors fragDescriptors; 
typedef fragDescriptors FragArray[1]; 


typedef struct codeFragRecord 
{ 


long Reserved]; 

long Reserved? ; 

long Version; 

long Reserved3; 

long Reserved4; 

long Reserved5; 

long Reserved6; 

long NumberofFrags; 

FragArray fragArray; //array[0..0] of fragDescriptors; 


}codeFragRecord; 


typedef struct codeFragRecord *codeFragRecPtr, 
**codeFragRecHandle; 


PROBLEM IDENTIFIED 

Given the task of designing a fat application that stores 
its data in its own data fork, you could take one of the 
following approaches. 

(1) Write additional code to handle the case of loading and 
saving documents. This code would need to calculate offsets 
to move the file’s mark to skip over the code fragment. 

(2) Compile your PowerPC application as a code resource. 
Write additional code compiled in the 68K version of your 
application that checks the environment on startup. If 
running on a PowerPC, load and execute the PowerPC 
resource (often referred to as an accelerated resource). 

(3) Not to write code, instead tell the Code Fragment Manager 
to look in a particular resource to find the code it should 
load and execute. 

Going back to the ‘cfrg’ editor in Resorcerer™ for a moment, 
we see that the usage field allows us to pick one of three options 
for our code fragment. If generating an application, this field is set 
by your development environment to indicate that the fragment is 
an application. Internally, the code fragment manager uses this to 
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determine how to prepare a particular fragment and load it into 
memory. Refer to Inside Macintosh, PowerPC System Software if 
you need additional information. 


Fragments *1 

Architecture type Power PC=‘pwpe’ 
[F] Update level Full library or application=0 
Current version $00000000 
Old version $00000000 
hl =TtTl i : i : i 
Library 
“Application +. 

Drop in extension 


Offset in data fork to fragment = Beginning=0 
Length ‘whole fork=0 


$00010000 


e C’alis’) ID) = None=0 


start On disk, flat (data forkJ=1 





Figure 3. The usage field popup in the ‘cfrg’ resource. 


More importantly the where does fragment start field allows 
you to change from the default location in the data fork. 


Fragments #1 
Architecture type Power PC="pwpec’ 
[) Update level Full library or application=0 
Current version $00000000 
Old version $00000000 
[) Application stack size $00010000 
Application subfolder alias C‘alis’) ID) None=0 
TF) Usage Application=1 


“On disk, flat (data fork) 


On disk, segmented (resource) |: 
In memory (ROM) 





Figure 4. The where does fragment start popup. 


To indicate to the code fragment manager that it should 
load the code from a resource instead of the data fork, select 
the segmented resource option. 


Application subfolder alias C‘alis’) ID) None=0 
[FF ) Usage  Application=1 
[FF ) where does fragment start On disk, segmented (resourceJ=2 


Resource type of fragment ‘????° 
Resource ID of fragment 0 





Figure 5. Change the location to point to a code resource. 


Enter the resource type and ID. 
Application subfolder alias Calis’) ID None=0 


[IF] Usage  Application=1 
[¥) Where does fragment start On disk, segmented (resourceJ=2 


- Resource ID of fragment 0 





Figure 6. Code fragment manager set to look 
for PCOD resource with ID 0 on startup. 
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Cut and paste the code from the data fork into the resource 
type you specified. On a PowerPC your fat application will load 
and execute from a resource, and the data fork reverts to its 
historical role. (Note: ‘PCOD’ is an arbitrary resource type I 
chose, if you need to use a different resource type, change the 
appropriate define in the DSGlobals.h header file.) 


General Notes 

You may be thinking, if I can do all of this with 
Resorcerer™, why do I need another developer utility? I initially 
took this approach. However, while I was developing my fat 
application I ran into the situation where copying and pasting 
1MB of code out of the data fork and into a new resource 
required me to set Resorcerer™’s preferred memory size to 
>10MB. This procedure is slow and tedious if part of a regular 
build cycle. Using the simple AppleScript I provide automates 
the entire build process and reduces any chance of user error. 


CODE LISTING 

All programs were developed using CodeWarrior 7 which 
ships with the latest universal headers (known as the 2.1 
universal interfaces). If you are using a previous version of 
CodeWarrior, or a different development environment, you may 
have to do some tweaking. For example, the GetKeys interface 
changed from long to unsigned long in the 2.1 headers. 

There are two applications that accompany this article. The 
MoveData utility uses the excellent DropShell framework by 
Marshall Clow, Leonard Rosenthol, and Stephan Somogyi. 
DropShell is available on the CW7 CD and on most on-line 
services. Refer to its documentation for more information. To 
use MoveData, drag the application you wish to alter over its 
icon, (or select it via the Open option under the File menu). 
MoveData will move the PowerPC code from the data fork into a 
code resource, and update the ‘cfrg’ resource to point to the 
correct location. Should you wish to reverse the operation, hold 
down the option key when you drop the application onto the 
MoveData icon. It copies the PowerPC code from the resource 
back to the data fork. 

The Demo program is a simple program that illustrates the 
technique of creating a self-running fat binary that reads and writes 
data from its data fork. After you build and run the program for the 
first time, it will prompt you to locate a text file, which it will copy 
into its data fork. On subsequent invocations of the demo 
program, it will read and display the contents of the data fork, then 
write the contents back to the data fork of the application reversed. 





UpdateCFRG 
Listing 2: DSUserProcs.c 
// Routine to update the ‘cfrg’ resource. Pass in the updated information and it will 
// update the ‘cfrg’ resource in the file specified by resRef. The Code fragment 
// manager checks for this resource first on startup if running on a PowerPC. 


static OSErr UpdateCFRG(short resRef, 
Byte fragmentType, 
Byte fragmentLocation, 
long fragmentOffset, 
long fragmentLength) 
{ 
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codeFragRecHandle cfrgHnd1; 
codeFragRecPtr cfrgRecPtr; 


OSErr -thebrror ==]: 


cfrgHndl = (codeFragRecHandle) GetlResource(‘cfrg’,0); 


if (cfrgHndl != NULL) 
{ 


HLock( (Handle) cfrgHnd1) ; 


(**cfrgHnd1l).fragArray|[0] .TypeOfFrag 


(**cfrgHndl).fragArray[0] .LocationOfFrag 


= fragmentLocation; 


(**cfrgHnd1).fragArray[0] .OffsetToFrag 
(**cfrgHnd1).fragArray[0].LengthOfFrag 


HUnlock( (Handle) cfrgHnd1) ; 
ChangedResource( (Handle) cfrgHnd1) ; 
UpdateResFile(resRef) ; 
ReleaseResource( (Handle) cfrgHnd1) ; 


return noErr; 


} 


return. thekrror : 
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= fragmentType; 


fragmentOffset; 
fragmentLength; 








ProcessItem 
Listing 3: DSUserProcs.c 
// This routine gets called for each item (in our case a Fat binary) that is dropped on the 
// MoveData utility. We will process and update the ‘cfrg’ resource as appropriate. Notice 
// the extensive error checking as there are several stages where things could go wrong. 


static OSErr ProcessItem(FSSpecPtr myFSSPtr) 
{ 

OSErr err = nokrr: 

short refNum; 

short resRef; 

long logEOF; 

long count; 

Handle POWER_PC_CODE; 

short resultCode; 

short itemHit; 


// If the option key is held down when an application is dropped onto MoveData, it will 
// reverse the process, i.e., move the PowerPC code from a resource back into the data fork. 


if (gReverseOperation) 


return (ReverseProcessItem(myFSSPtr) ) ; 


} 
err = FSpOpenDF(myFSSPtr, fsRdWrPerm, &refNum) ; 


if (err == noErr) 
{ 
‘ resRef = FSpOpenResFile(myFSSPtr,fsRdWrPerm) ; 
if (resRef != -1) 
{ 
err = GetEOF(refNum, &logEOF) ; 
if (logEOF == 0) 
{ 
itemHit = Alert(kNoDataFork,nil) ; 
} 
else 


{ 


// Check for PPC code 


if (logEOF < kMaxResourceSize) 
({ 


POWER PC _CODE = 
Get1lResource(kPowerPCCode,kPowerPCID) ; 

if (POWER _PC_CODE != NULL)  // Check for existing resource 

{ 
RemoveResource(POWER PC CODE) ; 
UpdateResFile(resRef) ; 

} 


POWER_PC_CODE = NewHandle(logEOF) ; 


if (POWER_PC_CODE == NULL) 
POWER_PC_CODE = 
TempNewHandle(logEOF, &resultCode) ; 


if (POWER _PC_CODE != NULL) 
{ 
count = logEOF; 
err = FSRead(refNum, &count, *POWER PC CODE) ; 


AddResource (POWER PC CODE, 

kPowerPCCode, 

kPowerPCID, 

”\pPPC Code”); 
WriteResource(POWER_PC_CODE) ; 
UpdateResFile(resRef) ; 
ReleaseResource (POWER PC CODE) ; 
err = SetEOF(refNum,0) ; // set the data fork to 0; 


err = UpdateCFRG (resRef, kUsageIsApplication, 
kFragmentInResource, 
kPowerPCCode, kPowerPCID) ; 
} 
else 


itemHit = Alert(kMemErrorID,NULL) ; 
} 
else 
itemHit = Alert(kTooBigID,NULL) ; 
} 
} 
err = FSClose(refNum) ; 
} 
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else 
itemHit = Alert (kDataForkError,NULL) ; 


return(err); 





checkforSelfContained 
Listing 4: Demo.c 
// Checks if this is a self running document, load and handle it if necessary. 


OSErr checkforSelfContained(short *vRefNumToSearch) 
{ 


Opire theError; 
ProcessSerialNumber theCurrentProcess; 
ProcessInfoRec theInfo; 

long fileLength; 

short refNum = 0; 

MenuHandle theMenu; 


theInfo.processName = NULL; 
theInfo.processInfoLength = sizeof(ProcessInfoRec) ; 
theInfo.processAppSpec = &gApplicationProcessInfo; 


theCurrentProcess.highLongOfPSN = 0; 
theCurrentProcess.lowLongOfPSN = kCurrentProcess; 


theError = GetProcessInformation 
(&theCurrentProcess, &theInfo) ; 
if (theError != noErr) 

return theError; 


theError = FSpOpenDF (&gApplicationProcessInfo, 
fsRdWrPerm, &refNum) ; 


if (theError == noErr) | 
theError = GetEOF(refNum, &fileLength) ; 


if (fileLength != 0) 
{ 
theMenu = GetMHandle(FILEMENU) ; 
EnableItem(theMenu,clearDataFork) ; 
theError = processFile(&gApplicationProcessInfo,refNum, 
fileLength) ; 


if (!theError) 
reverseFile(refNum) ; 
} 
else 
{ 
theError = appendTextFileToApp(refNum) ; 
} 


theError = FSClose(refNum) ; 
*vRefNumToSearch = refNumn; 


return theError: 


The best way to build the Demo program is to run the Build 
(Fat) Demo CW7 script. If you run the PPC project immediately after 
building it, the program will attempt to reverse itself, and on 
subsequent attempts it will fail (self-destruction). Note: You will 
need to edit the path in the script to get it to run on your machine. 

The echoed script is here for your convenience. 





Build (Fat) Demo 
Listing 5: 
// Simple Apple Script to coordinate the building a fat binary using the MoveData Utility. 


set PATHNAME to “HD:DeskTop Folder:MacTech:” 
set MOVEDATAFOLDER to PATHNAME & “MoveDataf” 


with timeout of 60000 seconds 
tell application “CodeWarrior IDE 1.3.1” 
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activate 

open {PATHNAME & “Demo68K.u”} 
Make Project 

Close Project 


open {PATHNAME & “DemoPPC.u”} 
Add Files PATHNAME & “Demo68K” To Segment 1 
Make Project 
Remove Files PATHNAME & “Demo68K” 
quit 
end tell 
tell application “Finder” 
activate 
select file “Demo (Fat)” of folder PATHNAME 
open selection using file “MoveData” 


of folder MOVEDATAFOLDER 
end tell 


end timeout 


Caveats 

One of the side effects of this approach is that the Finder 
information window for your application will not reflect that it is 
a PowerPC application. This is because the Virtual Memory 
Manager on Power Macs will only map your application into 
chunks that can be paged in an out, if the code resides in the 
data fork. By the time Copland rolls around, hopefully this issue 
will be moot, and the Finder will provide a better mechanism for 
determining if an application contains native code. With virtual 
memory turned on (and depending on the size of your PowerPC 
executable), you may notice faster application startup times since 
none of the virtual memory magic will apply to your application. 

If you are using Jasik’s the Debugger, your debugging strategy 
is unaffected as the Debugger will still kick in once you launch your 
application. You could have several self-running documents all 
built using the same run time module (with different information in 
the data fork). Then the Debugger will kick in, provided that you 
name the document and system files appropriately. 


MoveData Info 


a Movebata 
DropShell 2.0 


Kind: application program 
Size : 64K on disk (26,870 bytes used) 


Where: Kanth: MacTech: MoveDataf: 


Created: Sat, Oct 28,1995, 5:02 AM 
Modified: Sat, Oct 28,1995, 5:02 AM 
Version: Vert Sizing 


Comments: 


“Memory Requirements 
Suggested size: 394 


Minirnurn size : K. 
Preferred zize: K 


Mote: Memory requirements will decrease by 
10K if virtual mernory iz turned on in the 
Memory contro] panel, 


C] Locked 





Figure 7. Finder information for a PowerPC application. 
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MaveData 
DropShell 2.0 


Kind: application program 
Size : 32K on disk (26,903 bytes used) 


Where : Xanth: MacTech: MoveDataf: 


Created: Sat, Oct 28, 1995, 5:02 4M 
Modified: Sat, Oct 28, 1995, 5:21 AM 
Version: Vert Sizing 


Comments: 


“Memory Requirements ------ 
Suggested size: 384 K 


Minimum size : 100 | K 
Preferred size: K 


C] Locked 





Figure 8. Finder information for a PowerPC application 
processed using the MoveData utility. 


What other usage does this technique invite? I started 
thinking about this one night while driving home, and it 
seemed like an interesting way of storing optimized versions of 
your application under one umbrella (i.e., self configuring 
software that ran at maximum speed on 601, 603 or 604 
processors). It also gives the authors of virus protection 
programs another potential threat to consider, as this technique 
gives new meaning to the term Trojan program. 


THE VERDICT 
I hope the technique of moving program code out of the 
Data Fork and into a resource will prove useful in your own 
development projects. Drop me an e-mail message if you use 
this technique, or have any comments on this approach. 
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CLARIS ANNOUNCES CLARIS HOME PAGE 2.0 
FOR Mac OS AND WINDOWS 95/NT 


Claris Home Page 2.0 is the next version of web authoring 
software for Mac OS and Windows 95/NT users. New features 
include built-in site publishing, with auto-consolidation of files; 
support for popular multimedia plug-ins, including QuickTime 
and Shockwave; spell checking and support for multiple fonts; 
client-side image maps for linking to other pages and sites, and 
HTML editing enhancements such as syntax coloring (color- 
coding of HTML tags). 

Claris Home Page 2.0 users will also be able to re-size and 
position Frames by pointing and dragging with their mouse, 
preview background GIF images from within Claris Home Page, 
drag and drop tab-delimited text from spreadsheet and database 
documents to automatically create tables within their web page, 
and specify row heights and column widths within tables. 

The new version will also provide concurrence between 
WYSIWYG and HTML modes. This will allow users to go to the 
precise location in which they were working in the previous 
mode. <http://www.claris.com> 


NUMBERING STRATEGY FOR NEW SYSTEM RELEASES 

Apple recently released System 7.5.5 Update, a set of 
system software enhancements that significantly improves the 
overall reliability and performance of all Mac OS-compatible 
systems. It provides one update for all computer systems 
currently running System 7.5.3 and integrates all improvements 
found in the System 7.5.3 Revision 2 update released last June. 

System 7.5.5 includes numerous performance, reliability and 
network improvements. It is also the final system software release 
for the Macintosh Plus, SE, Classic, Portable, SE FDHD, SE/30, LC, 
II, IIx, and IIcx, and the PowerBook 100. Future Mac OS releases 
will require 68030-, 68040-, or PowerPC processor-based systems 
that support 32-bit memory addressing. 

Apple has also standardized how the version number will 
change for future system software releases. If major 
architectural changes are being delivered, the first digit of the 
version number will be incremented. If new features are 
added to a system software reference release without major 
architectural changes, the second digit will be incremented. 
When system software updates are delivered with only 
reliability and performance improvements, the third digit will 
be incremented. System 7.5.4 Update was not made available 
to the general public due to a problem with the software. 
<http://product.info.apple.com/pr/product.updates/1996/q4/960919.prd.up. 
sys7.5.5.htmL> 


NEWSBITS 





Do-IT-YOURSELF DATABASE(TM ) 


With DIY-DB, anyone can build working databases on the 
Web without a knowledge of database systems or CGI-scripting. 

Online configuration is easy with DIY-DB. Just load and go 
onto any server running Java, then link to common database 
engines such as mSQL or ODBC-compliant databases. DIY-DB 
makes it easy to build a database on the Internet or Intranet 
from scratch. Everything is done — down to the consistent look 
and feel of presented pages. It’s easy to add your own logos and 
text to customize databases for individual sites. 

DIY-DB let’s you present different views of the database, 
for example, private and public views. You can set password 
protection of each record or on an entire view. In each view 
you can allow or disallow operations such as deletion or 
addition of records and the ability to edit or re-edit existing 
records. Individual fields may be editable (read and write), 
visible (read-only) or invisible. 

The use of the Internet for business sales is increasing 
exponentially. Up until now, small businesses have been 
hampered by lack of skills and resources to easily publish 
database information such as catalogues. What Netscape has 
done for the Web in page presentation, DIY-DB is doing for 
database publication on the Internet or Intranet. 
<http://www.webventures.com.au/diy-db> 


Beta Release of ActiveX SDK for Macintosh Enhances 
Cross-PlatformSupport for ActiveX. 

Microsoft Corporation announced worldwide availability of 
the beta release of the Microsoft# ActiveX Software 
Development Kit (SDK) for the Macintosh. The move is an 
important step toward making ActiveX interpretability 
technology available across all popular computing platforms. 
With the new SDK, Macintosh developers can create native 
ActiveX Controls and interactive content that will be 
immediately viewed by users of Microsoft Internet Explorer 
version 2.1 for the Macintosh. 

Earlier this year, Microsoft announced an agreement with 
Metrowerks Inc., under which Metrowerks is providing integrated 
support for ActiveX and COM as well as the integration of ActiveX 
with Java in its industry-leading CodeWarrior application 
development products for the Macintosh. The ActiveX SDK for the 
Mac gives developers the programming interfaces and utilities 
they need, while the CodeWarrior products offer easy-to-use 
graphical tools for creating applications. 
<http://www.activex.org> [id 
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TIDBITS 





by Steve Sisak 


For a program I recently wrote, I wanted to do user input 
checking for a dialog box as they were typing into an EditText 
field. I wrote a routine to figure out what the contents of a 
specific EditText box will be if the current event is allowed to be 
processed. I then called the routine from my custom dialog 
event process, and analyzed the results. That way, I could easily 
decide if the user’s action would produce valid results, or if I 
needed to abort the current event. 

IsDlgControl is a simple check for control characters we always 
want to process. DivineNewltemString is the routine that does all the 
work. PStrCopy is a little routine for copying Pascal strings — I’m 
sure that other people have better ways of doing this. 


// some control key constants. 











#fdefine kEnterKey 3 
define kBackspace 8 
define kTab 9 
#fdefine kReturnKey 13 
#fdefine kEscapeKey a1 
#define kLeftKey 28 
#tdefine kRightKey 29 
#fdefine kUpKey 30 
define kDownKey a1 
#fdefine kDelete OxFF 
/* IsDigControl 


* Returns true if c is a special control key (say an arrow key, or escape). 
* Otherwise returns false. */ 

Boolean IsDlgControl(char c) 

{ 


if ((c >= kEscapeKey) && (c <= kDownKey)) return true; 

if ((c == kReturnKey) || (c == kEnterKey) || (c == kDelete) 
|| (c == kBackspace) || (c == kTab)) return true; 
return false; 


/* PStrCpy 

* A little routine to copy Pascal strings. Provided for those people who don’t 
* already use BlockMove( to do this for them ... */ 

void PStrCpy(Str255 s, const Str255 t) 


short i; 


for (i=0; i<=s[0]; itt) { 
sii )=tla]; 
} 


/* DivineNewltemString 
* Given a DialogPtr, EventPtr and an item number for the active EditText DLOG 
*Ttem, it returns what the string will be if the current event is processed. 
* Tt should be called from a custom dialog event proc. */ 
void DivineNewItemString (DialogPtr d, EventRecord *e, short 
item, Str255 
output) 
{ 
short *TEScrpLength = (short *)0x0ABO; 


NN 


DialogRecord ksi ag 








TEHandle teh; 

char oe 

str255 input, text; 
short selStart, selEnd; 
short a3 

short Sutstrlax=0: 
short iType; 

Handle iHandle; 

Rect , iRect; 

// get the text string 


GetDItem(d,item, &iType, &iHandle, &iRect) ; 
GetIText (iHandle,text); //Set the input string 
c = (e->message & charCodeMask) ; 
if (IsDlgControl(c)) { 
// if it’s a control char, return the item’s text. 
PStrCpy (output, text); 
return; 
} else if (e->modifiers & cmdKey) |{ 
if ((e =v’) || (c= ‘¥")) 1 
// if pasting, get the pasted string. 
(void)TEFromScrap(); 
HLock(iHandle) ; 
iHandle = TEScrapHandle(); 
for (1=0; 1¢ *TEScrpLéneth: itt) { 
input [it1]=((unsigned char *) (*iHandle)) [i]; 
input [0)}=*TESerpLeneth: 
HUnlock(iHandle) ; 
} else { //if any other command stroke 4 

PStrCpy (output, text); 

return; 
} else { //else, set the input string equal to the new character 
// else, set the input string equal to the new character 
input [0]=1; 
input[1]=(unsigned char) ec; 


// get the selection point from the TERec 

dr = (DialogRecord *)d; 

teh = dr->textH; 

selStart=(*teh) ->selStart; 

selEnd=(*teh) ->selEnd; 

// generate output string: copy the first bit of text 

for (1=1¢ i<=selStart: itt) { 
output [t+toutStridx]=text [i]; 


// copy the input string 
foe (i-ls Assinpet|0i¢ att). 4 
output [t+toutStridx]=input [i] ; 

} 

// copy the last part of text 

for (i=selindt]; i<=text[0]; a++), { 
output [ttoutStrIidx]=text [i]; 

} // lastly, set the length 
output [0] = outStridx; 

} 


Michael Trent 
mtrent@msn.fullfeed.com 
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http://(www.mactech.com 


(...and we really mean now.) 


Think of it as your source of news and announcements in the 
MacOS developer community. Loaded with up to the latest news, 
and constantly updated with developments in our industry. 


MacTech NOW” brings you up to speed on everything you need to 
know — instantly! And thanks to our new “fast-download” design, 
you'll get to the information you want in seconds. 


Give it a spin! Check it out today and get access to over 1500 pages 
loaded with news, tips, programming secrets, product reviews, and 
much more. And for those of you looking for some kicks, there’s the 
ever popular “Programmer’s Challenge” section where you'll get to 
bang heads with the best in the community. 


Log on to MacTech NOW. Things are happening right now, and you 
should be aware of them. 





MacTech, MacTech Magazine, MacTech CD-ROM, MacTech Web, THINK Reference, Developer Depot, Sprocket, JavaTech, WebTech, 
BeTech, Developer Central, Virtual Developer Central and the MacTutorMan are trademarks of Xplain Corporation. Other trademarks 
and copyrights appearing in this printing or software remain the property of their respective holders. 


LOCAT 





By Jim Straus, URLs@mactech.com 


Don’t hesitate to notify me at URLs@MacTech.com of any 
sites that you think would be of interest! As always, the full list 
is maintained on-line at http:/Awww.mactech.com/URLs.html. 


WEB WATCH 

December is the time of holidays, so appropriately, we will 
look at games and tools for developing games. Games are 
often the leading edge of applications. They drive graphic 
requirements, sound requirements, responsiveness, and even 
user interface. A game has to be intuitive in its use, and 
seamless in its action. Also, some of the tightest code can be 
found in games as their developers try to squeak out that last 
little bit of performance. This column will give you a leg up on 
the competition building the next blockbuster game. 


Jeremy Vineyard has put together a very nice site of 
information useful to game developers. He has included 
several useful pages including tips and techniques, graphics and 
design, and music. Jeremy is also looking for support for the 


site. If you can help, contact him. 
Butterscotch 
http://www.viperware.com/butterscotch/ 


Jumbo has been mentioned as a site with multiple resources. 
In one area, they have games to download. In another area, they 
have information for developers. Their source library contains 
many games from Chess to asteroid games. There are also 
sources to 3D and sprite engines that could be the basis for your 
own games. If you want to see how some of the freeware games 


were developed, this library should be of assistance. 
Jumbo (games) 
http://www.jumbo.com/pages/games/mac/ 


Jumbo (sources) 
http://www.jumbo.com/pages/programming/mac/development/source/ 


Apple’s game developer suite, Sprockets, has an abundance 
of good materials all bundled together. It has been mentioned 
before, but it is still a great resource for game developers. At 
the Sprockets web site, you will find information on network 
games, Quickdraw 3D, sound, input libraries, and more. They 
have also started to include links to other sites to help 


developers using Sprockets. 
Sprockets 
http://dev.info.apple.com/games/ 


Happy Puppy is a site devoted to games. They have now 
introduced a section for game developers. Included are multiple 
links that would help a budding (or experienced) game developer. 


UNIFORM RESOURCE LOCATORS 





If you just like playing games, check out the main Happy 


Puppy Site. 
Happy Puppy Game Devel. 
http://www.happypuppy.com/games/devel/ 


If you find that one of your games is having problems, you 
should check out this site of many game upgrades and patches. 
Even if you’re not having trouble, you might want the latest 
version of your game. There are patches and upgrades for all 


platforms, not just the Mac, and fixes for a number of bugs. 
Game Patches 
http://www.cdrom.com/~mr2/ 


Every game developer needs to keep up on their game 
playing skills. Here are a few sites with some of the best 
freeware and shareware games. You will also find demo 


versions for many commercial games. 
Mac Shareware Games 
http://www.astro.psu.edu/users/carkner/mac.html 


The Game Place 
http://www.melis.com/gamesplace/macgames.html 


Finally, check out stroyWeb. Josie Bloom has gone out and 
found various stories (mysteries, romances, SF, comedy, horror, 
etc.) and written reviews and summaries. It is one way to idle 


away some time while on the web. 
StoryWeb 
http://www.storyweb.com/cgi-bin/bestguml/homepage 


Thanks this month to Josie Bloom, Spec Bowers, Harold 
Halbleib, Jeremy Vineyard, and many others for their contributions, 
their suggestions and pointers to both new and old sites. 


QUICKIES 


InternetRelated eee 


MacOS Java Runtime —_=tttp://www.devtools.apple.com/mrj/ - 
MFC (formerly Project X) http://mcf.research.apple.com/ 


Other Programmer Resources 
Butterscotch http://www.viperware.com/butterscotch/ 
Happy Puppy Game Dev. http://www.happypuppy.com/games/devel/ oe 


Vendors, Products and Miscellaneous 


Excel Software 
MaclnTouch 


http://www.excelsoftware.com 
http://www.macintouch.com/ 
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And our skills are pretty sharp, too. 

We can trim your content, hone your design, and 

implement a Web site that’s...well...a cut above the rest. 
With today’s chopped budgets and pared-down schedules, you 

need JointSolutions Marketing. We have the experience, and the tools, 

to make sure your World Wide Web pages aren’t...you know...dull. 








We even have a Web server, so site maintenance and updates 4 JointSolutions Marketing 
don't slice into your work time. I = ls Sd eee - ae | 
’ 4 -Mail: Intro@jointsolutions.com 
Call us today and we'll take a whack at your Web needs. eAneeNG: fa as i sreoueonscon 
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phone can be placed M - F from 9:00 a.m. to 5:30 p.m. pacific time at 1-800-MACDEV-T. 





SPECIAL DEAL! 


See page 2 











Developer Depot 30 day Money Back, Price and 

Satisfaction Guarantee 

Developer Depot products are sold with a 30 Day money back guarantee on 
user satisfaction, lower prices and against defects. If, for any reason, you are 
not satisfied or find the same product at a lower price within 30 days, please 
call Customer Service at 800-MACDEV-1 and request a Return Merchandise 
Authorization (RMA) number to get a full refund or the difference in price 
(where applicable). You must return undamaged product at your expense, 
including all its original packaging, documentation and the blank warranty 
card if applicable. Developer Depot will replace defective product upon 


Stuff our lawyer made us write. 
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See page 3 
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BBEdit 4.0 ...............See page 8 
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receipt of the defective merchandise. Please remember to back up your data 
before installation of any new hardware, software, or peripherals; we cannot 
be responsible for any lost data. Policies, itém availability, and prices are sub- 
ject to change without notice. The price in effect when we receive your order 
will be the price that you are charged. We are not responsible for any typo- 
graphical errors in this or any other catalog, nor for any misstatements from 
any vendor. Purchase orders are also accepted but must be in writing, signed, 
come with a contact person and a telephone number, and mailed to P.O. Box 
5200, Westlake Village, CA 91359-5200. Faxed copies and purchase order 
numbers alone are not acceptable. 


Developer Depot makes no other warranties. All other warranties, either expressed or implied, riaurorb the implied warranty of merchantability and fitness for a particular purpose 


are disclaimed. Developer Depot shall not be liable for any direct, special, incidental or consequential 
al injury arising from the use of any product sold through Developer Depot. The limit of direct damages, if any, shall not exceed the purchase price cf the product.© 19 


amages including lost profits, from any delay in delivery, or for ces pesos 
plain 


Corporation. All rights reserved. Any unauthorized duplication is in violation of federal laws. Developer Depot is a registered trademark of Xplain Corporation. All product names in 


this catalog are the trademarks of their respective holders. 


© 1996 Xplain Corporation. All rights reserved. Any unauthorized duplication is in violation of federal laws. Developer Depot is a trademark of Xplain Corporation. All product names 


in this catalogue are trademarks or registered trademarks of their respective holders 
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For Macintosh 
Programmers & Developers 





Subscriptions: US magazine: $47 for 12 issues (MTYRDM 
Canadian: $59 for 12 issues (MTYRCM 

nternational: $97 for 12 issues (MTYRFM 

Back Issues: $10 each (subject to availability 





MacTech CD-ROM Volumes 1-11 


¢ 1420+ articles, from all 127 issues of MacTech Magazine (1984-1995). 

e Improved hypertext, and a new THINK Reference Viewer — for lightning 
quick access! ¢ New hyperlinks between articles. ¢ 100+ MB of source code 
— use them in your own applications, with no royalties! e Full version of THINK 
Reference™ — the original online guide to Inside Macintosh, Vols. I-VI. 

¢ 80MB of FrameWorks/SFA archives. The most complete set of FrameWorks 
archives known. ® Sprocket™! MacTech’s Tiny Framework that compiles quick- 
ly and supports System 7.5 features. ¢ The best threads from the Macintosh 
programmer newsgroups plus thousands of notes, tips, snippets, and gotchas. 





Limited time offer" Buy 


¢ Popular tools that Macintosh programmers use to increase their productivi- 
Volume 11 NOW, and geta ty ani much more i 
frree upgrade to the soon- List $89.00 Our Price $79.00 (smtcp11 
to-be-released Volume 12! Upgrades: Our Price $39.00 SMTCD11U 


Free shipping on the upgrade! 
MacTech Mouse Pad 


Slide on this! With an extra-large surface (11” by 10”) and a deluxe sleek 
plastic coating, you'll be zooming across your screen in no time at all. 
speed limit not enforced! 


Our Price $8.95 (AMTPAD 
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Best of MacTutor 


The Best of MacTutor Collection, Vols.3-5. 
List $99.00 Our Price $9.95 per set (BMTBEST). 
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CodeWarrior 10 Gold by Metrowerks 


e New improved IDE - graphical browser view, global preferences and an improved external 
editor! 

e Full Java toolkit: project manager, linker, editor, class browser, source-level debugger, 
applet viewer and more! 

e Everything you need for industrial-strength programming. Develop for Macintosh, Power 
Macintosh, Windows 95, Windows NT, Magic Cap and BeOS. 

e Award-winning, easy-to-use IDE supports C/C++, Object Pascal and Java. 

e Includes online books, extensive reference material and Apple Guide files for easy naviga- 
tion through tutorials and examples. Two free updates and technical support included 
with registration. 


Our Price (SCWGOLD) 


SEE RELATED PRODUCTS: @ Code Manager e Inside Power Plant ¢ Inside CodeWarrior 9 
e C++ Programming with CodeWarrior ¢ PowerMac Programming Starter Kit ¢ Discover 
Programming for Macintosh ¢ Learn C on the Macintosh ¢ Metrowerks CodeWarrior Programming 





Discover Programming for Macintosh 

e Includes full working version of CodeWarrior along with three 
online tutorial books and Dave Mark’s “Learn C on the 
Macintosh” converted to AppleGuides. 


online documentation and source code examples for all lan- 
guages and platforms. 
e The IDE software has been localized in eight languages plus 


e Includes C, C++ and Object Pascal compilers for generating ae ia is not sold as a Scans . 
68K Macintosh code, source-level debuggers, object-oriented  ° !neludes a 3 month subscription to MacTech Magazine. 


frameworks (PowerPlant, MacApp), Apple’s MPW, complete Our Price (SCWDISCMAC) 
SEE RELATED CATEGORY: Dev. Environments 





CodeWarrior Wear (x only) ie 
You live it, you breath it... you might as well wear it! (=, 
e Black CodeWarrior Sweatshirt: G ao, 
Our Price (ACWSWEAT) om, 
e “Blood, Sweat & Code” black long-sleeve shirt: | Doge 
Our Price (ACWLBLOOD) f nial 
_ © “Blood, Sweat & Code” black short-sleeve shirt: aa 
CodeWarrior _. Our Price (ACWSBLOOD) - 
| e Hawaii Five-O shirt: a 
Our Price (ACWHAWAI) / iam 
e Arnold at work T-shirt: - 
Our Price (ACWARNLD) hana 
e Hat: Our Price | \P 
Please Specify: Black (ACWBHAT) or White (ACWWBHAT) — Vw 
e Winter Hat (See Web site) 
Our Price (AWINHAT) 


Presenting Magic Cap, A Guide to General Magic’s 


Revolutionary Communicator Software 


e Perfect for novices as well as experts who want to take full advantage of Magic Cap. 

e Step through its screens, see how it works, and learn ways to use it. 

e Describes the power of smart messaging to customize the way you handle e- mail, a name card 
file that learns how to keep track of your contacts, a datebook that performs like a faithful assis- 
tant, and countless other abilities. 


List $16.95 Our Price (BPRESMAGIC) 
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Web site: http://www.devdepot.com ¢ E-mail: orders®@devdepot.com 





Symantec C++ 8.5 


e Native for Power Macintosh. 

e Develop full-featured Power Macintosh applications quickly and 
easily! 

e Environment includes: a true native Power Mac implementation 
of the C++ language, MrC/MrC++ compilers for fast Power 
Mac executable code, Visual Architect for fast, easy GU! genera- 
tion, a new THINK project management system that supports 
complex applications, a new editor/browser , a powerful, easy- 
to-use source code debugger. 

e Also includes: The industry-standard THINK Class Library! 

e Next two updates free when you send in your registration card 
and more! 


List $499.00 Our Price $349.00 (ssymcpp) 


SEE RELATED PRODUCT: Symantec C++ Programming, Learn 
C++ on the Macintosh, Programming in Symantec C++, 
Mastering the THINK Class Library. 


Rin 






Symantec C++ for 68k 

e The standard in development languages. ¢ Powerful combination of fully integrated visual tools and the latest in C and 
C++ compiler technology. * Provides an object-oriented approach to application development. ¢ Write code that is exten- 
sible, reliable, and maintainable. Includes: Integrated Environment with full source-code debugging, Incremental Linker 
which eliminates long link times, THINK Class Library, AppleEvents, Visual Architect™, THINK Inspector, Project Models, 
Source-Code Control with integration with Apple’s SourceServer (included), Support for Scripting, Powerful Standard 
Libraries which includes I/O Streams, ANSI standard C library, and sample programs. ¢ Full source code is included — 
Create applications that run on 68K Macs and Power Macs (emulated). These applications can easily be migrated to 
native Power Mac, by trading up to Symantec C++ for Power Mac. 


List $299.00 Our Price $99.00 (SsYMCPP68k) 
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Think Pascal Version 4.0 
by Symantec Corporation 


e Great for professionals and students 

e Fully integrated for rapid turnaround time — 
take advantage of System 7 capabilities 

e Supports large projects, enhanced THINK Class 
Library, System 7 compatibility, superior code 
generation, and smart linking. 

e Includes four Macintosh disks, a user manual, 
and an object-oriented programming manual. 


Our Price $165.00 (SPASCAL) 


Fortran 77SDK by Absoft 


e Dynamically linked shared libraries, memory mapped file 
access and integrated UNIX and Macintosh development tools. 

e BSD 4.4 and conforms to the Federal Information Processing 
Standard 151-2 (the POSIX FIPS). 

e Pre-emptive multitasking for UNIX applications and includes a 
full featured high-performance TCP/IP protocol stack that sup- 
ports multi-homing and multi-casting, features not yet avail- 
able even with Apple’s new Open Transport. 

e A complete UNIX software development environment with a 
source-level debugger and C, C++, and Fortran compilers all 
generating native PPC code. 

e Also included is a high-performance X server and complete 
X11R5 X. 


Our Price $695.00 (sm1oPPc) 
SEE RELATED CATEGORY: Internet Related 


For Power Macintosh includes a globally optimizing native compiler and linker, native Fx™ multi-language debugger, and Apple’s 


MPW development environment. 


de SIR 5S BRB a aR RE i A 


e The compiler is a full ANSI/SO Fortran 77 implementation, and includes all MIL-STD 1753 extensions, Cray/Sun-style POINTER, 
and several Fortran 90 enhancements ¢ MRWE, Absoft’s framework library is included in the MIG graphics library ¢ Supports the 
native Macintosh PPC toolbox ¢ Includes Absoft’s Fx debugger which can debug intermixed FORTRAN 77, C, C++, and PPC assem- 
bler © The linker compiler, and debugger all run as native PPC tools, and produce Macintosh PPC executables 


Our Price $699.00 (SF77) 


DEVELOPMI 


1-800-MACDEV-1 ¢ Outside U.S. & Canada: 805-494-9797 ¢ Fax: 805-494-9798 
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» NS BASIC 3.5 for the Newton with Visual Designer 


e A fully interactive implementation of the BASIC programming language. ¢ Runs entirely on the Newton — 
no host is required. 

e Create files, access the built-in soups, and the serial port for input and output. ¢ Work direct- 
eg ly on the Newton, or through a connected Mac/PC and keyboard. 

© Get the BASIC Internet Tool, available at no charge to NS BASIC users from 
~ www.nsbasic.com. Release Notes with sample code are available from the same location. 
e Runs on any Newton MessagePad 130 with NS BASIC and the Newton Internet Enabler. 
Also runs on MP 1201s with NOS 2.0 that have full memory available. ¢ Write short pro- 

Jrams to access News, mall and the web.e Create custom newsreaders that do filtering or archiving ¢ Load a spreadsheet or stock 
rade triggering program with stock prices from the web. ¢ Send mail containing data collected in an NS BASIC program ¢ Update a 
Jatabase with data sent by email. 


List $99.00 Our Price $94.99 (SNSBASIC) 












Mjoiner BETA System 


e Software development environment supporting object-oriented programming in the BETA programming language. ¢ Uniquely 
expressive and orthogonal. ¢ Unifies just about every abstraction mechanism — including class, procedure, function, coroutine, 
process and exception. © Includes: general block structure, strong typing, whole/part objects. The compiler: binary code generation, 
automatic garbage collection, separate compilation, interface to C, Pascal, and assembler. ¢ The system: persistent objects, basic 
libraries with containers classes, platform-independent GUI application frameworks on Unix, Mac and Windows NT, metaprogram- 
ming system. ¢ The Mjginer BETA System for Macintosh requires MPW (basic set) 3.2 or later. Package containing compiler, basic 
libraries, persistent store, GUI framework, and comprehensive documentation. (Other packages are also available). 


List $295.00 Our Price $245.00 (SMJOLNER) 
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Personal MachTen for 68K Macs hex 
e MachTen UNIX for Macintosh (from Classic on up, including PowerBooks and Duos) : aS. 
e A Mach-based Berkeley UNIX with pre-emptive multi-tasking ys 
e Extends the Mac OS with UNIX networking and software development tools. bd 
e Built-in internet services include domain name service, POP mail service, internet routing, SLIP & PPP, and Web service. (ae, 
Our Price $495.00 (SM10OPER) Also Available: MachTen XWindows Our Price $350.00 (SMACHX) wed 
SEE RELATED CATEGORY: Internet Related om 
-—, 
a 
JV¥~o% 
TS 
Ec Y 
-* Here’s a list of all available products. aes 
For full product descriptions please see our Web site, or feel free to call, fax, a 
or E-mail us. Z ee 
PRODUCT CODE LISTPRICE OUR PRICE a, 
Personal MachTen for 68K Macs SM10PER $600.00 $495 ~~ 
CMaster SCMASTER $129.95 $129.95 / [ml 
CodeWarrior Discover Java SCWDISCJAVA $99.00 $99.00 am, 
LPA MacProlog Developers Edition SLPAD $1500.00 $1500.00 ~ 
LPA MacProlog Programmers Edition SLPAP $745.00 $745.00 ae 
LS FORTRAN SLSFORT $695.00 $695.00 ) pan 
Mac FORTRAN II SFORT2 $595.00 $549.00 le 
Professional MachTen for 68k Macs SPROM10 $695.00 $695.00 a 
SmalltalkAgents SSTA $695.00 $695.00 
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Web site: http://www.devdepot.com © E-mail: orders@devdepot.com 












Roaster Subscription™ Roaster™ 
From Natural Intelligence Inc. Get the most out of Sun’s From Natural Intelligence Inc. 


new Java™ Programming Language! e Price includes the current DR 2 release _ 

e Write, test and run Java applets on the Macintosh in a full- and the first non-developer release. 
featured Mac development environment List $179.00 

e Features include: project window that includes a finder-like Our Price $129.00 (SROAST1) 


view of packages, Macintosh native compiler, source code edi- 
tor with powerful search features and intuitive use interface, runtime engine for 
quick and easy applet testing. 

e Requirements: PowerPC based Macintosh, CD-ROM. 

e Price includes the current DR 2 release and the next two non-developer releases. 


List $399.00 Our Price $299.00 (sroasn 
SEE RELATED CATEGORY: Dev. Environments 


Symantec Café 


symantec Café for Macintosh is a standalone, iOei Eure cee cee: 

professional Java development environment —_— 

that replaces the previously released 

symantec Caffeine Java tools. Café is ideal for both novice and professional Java developers. Café 
includes an "Intro to Java Programming" tutorial, Java language reference, Café Studio visual tools for 
graphically drawing Java applets on screen and having the corresponding source code generated auto- 
matically, and over 90 sample applets that can be Easily modified to create your own custom applets. ¢ 
For professionals familiar with programming, Café provides an unrivaled feature set, including an inte- 
grated graphical class browser, fast native Java compiler, a full-featured project manager, a professional 
Java source code editor, and full support for AppleScript and AppleEvents for automating time consum- 
ing tasks. ¢ Café comes with one year of free access to symantec Java Central, including the right to 
download patches and updates as they become available. 

$99 (SSYMCAFE). SEE RELATED CATEGORY: Dev. Environments 





OOFILE HTML Writer 


The first OODBMS framework to offer a complete solution for application authors. Replaceable backend database, currently Faircom’s 
c-tree Plus for cross-platform royalty-free power. PowerPlant and other frameworks integrated with edit fields, database browsers and 
more. AppMaker users, generate complete applications. User-friendly syntax makes it easier to migrate from FoxPro and the non-00 
world. Demo's on CodeWarrior and AppMaker CD’s. $895.00 (SOOFCTREE) for a once-off c-tree bundle, or $1,095.00 (SOOFSUB) 
lyear subscription. HTML and character-mode report-writer $1 95.00.(SOOFHTML) Full GUI report-writer, including HTML, is $495.00 
(SOOFGUI). Mac Platform Bundle - includes all Mac frameworks, c-tree, and Report-Writer. $1,495.00 (SOOFBNDL). 

SEE RELATED CATEGORY: Tools, Libs & Utilities 


TCP/IP Scripting Addition™ 

e Award-winning AppleScript scripting addition 

e Allows you to write scripts using MacTCP™ commands in AppleScript™ . 

e Send e-mail or files through a script, check if users are logged on (via Finger), automate 
FTP, Gopher, NetNews, Telnet, and LPR, verify links in HTML documents, and quickly write 
many other TCP/IP client-server programs. 
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, 7 , , TCP/IP 
| = Works mm AppleScript, MacTCP 2.0.4 and Open Transport 7 Scripting Addition” 
¢. Our Price $49.00 (stcp) SEE RELATED CATEGORY: Scripting The internet Scripting Solution 
: : oe 2 | | there S _Here’s a list of more products. For full product descriptions please see our 
7 - / Web site, or feel free to call, fax, or E-mail us. 
fe | PRODUCT CODE LISTPRICE OUR PRICE 
| CodeWarrior Discover Java SCWDISCJAVA $99.00 $99.00 
SmalltalkAgents SSTA $695.00 $695.00 
Tenon Ported Applications CD SPORTED $50.00 $49.95 


1-800-MACDEV-1 © Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 





FaceSpan”™ v2.1 


e Develop Integrated Software ¢ Make Stand Alone Applications ¢ Create Friendly 
Interfaces ¢ Develop Quick Prototypes ¢ Print multiple pages with sophisticated layouts 
e Script essential elements of the FaceSpan application ¢ Play and record sounds as 
either “snd” resources or as “AIFF” files. ¢ Create miniature or complete applications 
that will run on either Power PC or 68k computers. ¢ Use precise time measurement for 
implementing timed behaviors. « Enhanced Save Options « New Properties 

e Proportionally scale PICT images ¢ Align images in a pictbox ¢ Monitor and respond to 
low-memory situations ¢ Automate any application © Increased support for Frontier 

User Talk! 


List $299.00 Our Price $279.00 (SFACESPAN) 





Script Debugger by Late Night Software Ltd. 


e A powerful and flexible AppleScript authoring tool — get the most from Applescript! 

e Advanced debugging environment offers single-step script execution with breakpoints. 

e Script Debugger dictionary browser features a graphical view of objects provided by 
scriptable applications. 

e Includes Late Night Software Scripting Additions — a collection of more than 70 new 
AppleScript commands, and Scheduler, a utility that allows you to launch scripts at pre- 
determined times. 


ist $129.00 Our Price $119.00 (speBuc) 
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ae iS W 2 re g - Scripter 2.0° by main Event 

pe e e Whether you’re looking for a tool to introduce yourself to AppleScript’s unmatched capabili- 
ties, or a well-crafted development environment, Scripter, the Script Construction Set, is the 
obvious choice. FaceSpan 2.x integration: If you use the FaceSpan 2.x interface creation envi- 
ronment from Digital Technology International, you can use Scripter seamlessly instead of 
FaceSpan’s basic editor, to write, test and debug scripts attached to objects in FaceSpan. 
Scripter and FaceSpan work together: one click opens your FaceSpan script in Scripter, anoth- 
er sends it back. ¢ Debug handlers without modifying your scripts using the Call Box, a special 
window for calling individual routines in a script. ¢ Live editing: simulate applet, CGI, FaceSpan 
messaging Interactively debug live interapplication messages sent to a script application or 
AppleScript CGI from an applet, your Web server or FaceSpan 2.x. You won't have to modify 
your Web pages or your CGls. ¢ ScriptBase is now included with Scripter. Use It to store your 
data and media elements (frequently used values, text, pictures, scripts, HTML, headers, file 
references) and share them between scripts all with a special new browser. ¢ Easily write and 
compile scripts that have handler declarations and other vocabulary specific to a particular 
scriptable application. ¢ Scripter is the natural companion to AppleScript for users at all levels 
of proficiency. Don’t write scripts without it! 


List $199.00 Our Price $179.00 (sscriPTER) 
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le 
there S _ Here are more products. For full product descriptions please see our Web 
- site, or feel free to call, fax, or E-mail us. 


PRODUCT CODE LIST PRICE OUR PRICE 
DogPatch SDOGPATCH $299.00 $199.00 
PreFab Player SPLAYER $95.00 $95.00 
scriptBase SSCPTBASE $59.00 $59.00 
scriptWizard SWIZ $89.00 $84.95 


Web site: http://www.devdepot.com ® E-mail: orders@devdepot.com 
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BBEdit 4.0 from Bare Bones Software 


e A powerful, easy-to-learn text editor. 

e Adds new features for HTML coders, including a spelling checker and HTML tag 
palette. 

e Accelerated for Power Macintosh; dragging supported everywhere; Internet Config 
aware; Powerlalk aware. 

e Integrated support for Symantec’s IDE, Metrowerks CodeWarrior, THINK Reference 2.x, 
MPW ToolServer, and most other environments. 

e Many UNIX style tools, including “grep” searches, file comparisons, and sorting. Multi- 
file search and replace. 

e PopUpFuncs feature lets you jump to a function from a menu. 


List $119.00 Our price $94.00 (sepepin 
SEE RELATED CATEGORY: Internet Related 








QUED/M 3.0 by Nisus Software 


e The programmer’s text editor that defined the industry standard for speed and efficiency. 

e PowerPC native. 

e Features integrated support for Symantec C/C++, Metrowerks CodeWarrior 6, and MPW. 

e Supports all the major development environments on the Macintosh. 

e Dozens of powerful editing features, including unlimited undo and redo, macro language, 
scripting, text folding, ten editable/appendable clipboards, markers, displaying text as ASCIl 
codes, dynamic coloring of C/C++ keywords/comments, rectangular and non-contiguous 
selection. 

e Includes Celestin Company’s APPRENTICE 4. 


List $149.00 Our Price $89.00 (squepm) 





Movie Gleaner Pro 1.2 by Terran Interactive 


e Compress QuickTime movies 

e Powerful and easy-to-use 

e Includes: drag and drop batch processing, suspend and resume, 
adaptive noise reduction, IMA audio compression, high quality crop 
and resize, A/V fades, gamma correction, de-interlacing and more! 

e Automatically suggests the best settings for your application. 

e Great for both beginners and experts 

e Essential for CD-ROMs or Web sites 


Our Price $189.95 (smovie) 
SEE RELATED PRODUCTS: Quick Time Official Guide 
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CodeManager by Metrowerks 


e Source code control system for the Macintosh. 

e Based on and compatible with Microsoft Visual SourceSafe version 4.0. 

e Works with any type of binary file including graphic, database, library and 
executable files. 

e Includes support for multi-platform projects, security features, reverse delta 
versioning of files, comment areas for each revision, project analysis and 
reporting tools. 

e Sold on a subscription basis with two future product updates. 

e Includes a 1 year MacTech subscription. 


Our Price $399.00 (scomcr) 


SEE RELATED CATEGORY: Dev. Environments 


Voraorennterrtorannoracrortoreron 


Doubling Options 
©) Best Performance 

©) Better Performance 
©) Good Perfor mance 


@) Custom Performance 
Edit Processes... 


Special Settings 


Exclude Files... 


[_] Exclude Background-Only 
CIE Find 











CronManager 
by Orchard Software 


e Implements the UNIX Cron facility. 

e Open any Macintosh file on a given 
date and time. 

e Simple interface. 

e Works with any Macintosh file. 

e Cron Manager bundled with CLImate, 


Our price $26.95 (scronmer) 


CPU Doubler by orchard Software 

e Performance enhancement utility for the 
Macintosh. 

e Increases the speed of your computer by 100%. 

e Works on both the PowerPC and 68K Macintosh. 

e Manages computer throughput using a propri- 
etary scheduling algorithm. 

e Ensure optimal performance and compatibility. 


Our Price $79.95 (scpu2x) 


FILE a File Genie Pro by Duet Development 


under 10 seconds. 





e File Genie Pro lets you search ALL your developer CD-ROMs at once! 
e Every Dev CD, OS SDK, CodeWarrior CD, E.T.0., and Bookmark CD you insert 
is cataloged automatically. A typical Dev CD with 10,000 files is cataloged in 


e You can also catalog opticals, SyQuests, and floppies. 

e File Genie Pro quickly finds any file on any disk by searching hard disks, 
network servers, and catalogs. Open, show, print, and more. View text 
and graphics files without opening other applications. 


e When acting on an ejected disk file, File Genie Pro tells you which disk to 
insert, then continues automatically. 


Our Price $49.00 (scente) 


Guide Composer” 1.2 by StepUp Software 





e Create powerful Apple Guide help systems for any new or existing Macintosh application. 

e Provides a WYSIWYG development environment: Guide content is developed in Guide windows. 

e Design topics, phrases, and panels in the same format as the user will use them. Features are WYSIWYG interface, 
Topics, phrases, and hierarchical phrases, Coach marks, Fully-Integrated with Apple’s Guide Maker (distributed with Guide 
Composer), compiles scripts automatically, PICTs in Panels, Generated Guide scripts are modifiable. 

e FREE Update to all registered Guide Composer users. Demo is available at http://www.guideworks.com/. 


Our Price $99.00 sccomp) 


SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman’s AppleGuide Starter Kit, Real World AppleGuide 


Web site: htto://www.devdepot.com ® E-mail: orders@devdepot.com 


ct 
Be 
: 
ae 
ie 
ee 
# : 
# 
# 
Be 
a 
ee 
Be 


Ga ole anata Gin coat Bor ons 


bee x 


Abn? s 


Somes, 


ARIES: 3 ‘Tt ae : SS 


7 


A 





Be eee 4 
bee a cee 


x 
a 





Memory Mine py Adianta 


e Monitor heaps, identify problems such as memory leaks, 
and stress test applications 

e Active status of memory in a heap is sampled on the fly: 
allocation in non-relocatable (Ptr), 
relocatable (Handle) and free space is shown, as are heap 
corruption, fragmentation, and more 

e Allocate, Purge, Compact, and Zap memory lets users 
stress test all or part of a program 


List $99.00 Our Price $94.99 (smemmine) 
SEE RELATED CATEGORY: Dev. Environments 
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e Version control tool for the simple and clear management of projects in which files 
are created in numerous versions (variants and revisions). 

e Allows both variant and revision control, and it manages not only variants and rev 
sions of single files, but of a whole software project (multi files, multi users, multi 
variants, access rights, etc.) 


e Graphical user interface and is not only suitable for mere source code control but can 
handle all different kinds of files with amazing compression rates: typical size of delta between arbitrary files 5% 


e Please note special prices for multiple copies: 


Single license $229.00 svoon001); 2 pack $359.00 (svoop002): 5 pack $799.00 (svoon005): 10 pack 
$1369.00 (svooD0010); 20 pack $2399.00 (svoon0020) 


Additional pricing available on request. 
SEE RELATED CATEGORY: Dev. Environments 


QC by Onyx Technology. High performance runtime stress testing for applications. 


e Tests include heap checks, purges, scrambles, handle/pointer validation, dispose/release 
checks, write to zero, de-reference zero as well as other tests like free memory invalida- 


tion and block bounds checking. 
e Extremely user friendly — ideal for non-programmer testers. 
e Also available in Japanese. 


List $99.00 Our price $94.99 (sac) 


StoneTable 


e Replaces all functions found in list manager 

e Variable size columns/rows; different font, size, style, forecolor, 
backcolor per cell; sort, resize, move, copy, hide columns/rows; 
edit cells/titles in place; titles for columns/rows; multiple lines 
per cell; grid line pattern/color; greater than 32k data per 
table; up to 32k text per cell; support for balloon help and 
binary cell data. Versions for Think C, Think Pascal, MPW C, 
MPW Pascal, CodeWarrior 6 C. 


StoneTable Extra 


e Drag selected cells within table or to other tables. 

e Add rows as part of drag; popup menus or check boxes in 
cells; variable width grid lines; move/drag/resize table in 
window; clipboard operations on multiple cells. 

e Requires Stone lable. 








This product can now be ordered in 3 different packages. 


68K StoneTable 


This includes StoneTable, StoneTableExtra for Think Pascal, Think 
C, MPW C, MPW Pascal, CodeWarrior C, CodeWarrior Pascal 


Our price $175 (SSTONE6s) 


PPC StoneTable 


This includes StoneTable PPC, StoneTableExtra PPC for Think 
C, MPW C, MPW Pascal, CodeWarrior C, CodeWarrior Pascal 


Our price $1 75 (SSTONEPPC) 


68K/PPC StoneTable 


Includes both packages 
Our price $325 (SSTONEFAT) 
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SoftPolish CD-ROM by Bare Bones Software 


e The essential tool for software quality assurance on the Macintosh 
e Helps you identify inconsistencies with Apple’s user interface guidelines, misspelled 


words, missing resources, and other mistakes 


e Provides tools to put the finishing touches on software distribution packages prior to 


release 


e Works independently of any programming language or environment 
e Ideal for sanity checking software throughout the development process. 


List price: $99 Our price: $89 (SSOFTPOL) 


PowerTap by Fortner Research 


e Accelerates software by tapping into multiple processors. 

e Easy API — submit tasks and retrieve results! 

e Full error recovery system plus scheduling algorithms for 
optimal assignments and fastest possible execution. 

e Compatible with all Macintosh hardware, software and major 
compilers. 

e For non-commercial use. 


Our Price $299 (spowrap) 


dt. 


e True relational database system for Apple Macintosh comput- 
ers. 

e Provides a powerful choice for developers who want to create 
database centered applications with no performance trade- 
offs. 

e Features SQL, full transaction control, error recovery, single 
user, Client server architecture and multi-platform support 
including DOS, Windows, OS/2 and UNIX. 





Spyer by inCider 


e Easy to use tool that records all actions (including mouse 
movement) you perform on a Macintosh computer and then 
replays them at your 
preferred speed. 

e Recorded data can be saved in files for future use. 

e Works as a background process with any Macintosh applica- 
tion and is triggered by user defined Hot Keys. 

e Enables the “Continuous Redo” utility and is especially useful 
for software testing and demonstration. 


Our price $39.00 (SSPY) 
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PictureCGDEF 1.3 by Paradigm Software 


e Professional-level CDEF for creating custom graphical buttons (8- 
64 pixels) — used in products by Adobe, ProVue, STF Technologies 


and others! 
e Multi-monitor and bit-depth sensitive. 


e The button graphic (cicn, ResEdit) can be changed at runtime and 


even animated with a call-back routine. 


e Create distinct buttons in seven variations: MultiState, PushButton, 


FlexiButton, ToggleButton, ChkButton, PushPictButton and ~ 
TogglePictButton. 
e Manual, sample code and MacApp 3.0 support included. 


Full source code: $95.00 (spcper) 
Object code: $45.00 (srictoB,) 


e The C/C++ API is identical and fully portable across all 
supported platforms. 

e Third-party vendors supporting dtF will be able to offer a vari- 
ety of advanced features and benefits to their customers royal- 
ty free. 

e Jools are included for importing, exporting, creating and 
managing databases and users. 

e Supported development environments include: Symantec, 
MPW, Metrowerks and more. Mac/SDK 


List $695.00 Our Price $679.00 (sptF) 


Spellswell Plus 2.0.4 


e Award-winning, comprehensive, practical spelling checker that 
works in batch mode or within applications that incorporate the 
Apple Events Word Services protocol (e.g., Eudora, 
WordPerfect, Communicate!, and InfoDepot). 

e Checks for spelling errors as well as common typos like capi- 
talization errors, spaces before punctuation, double word 
errors, abbreviation errors, a/an before vowel/consonant, etc. 

e MacTech orders include developer kit with Writeswell Jr., a 
sample AppleEvents Word Services word-processor and its 
source code. 

e Available for OEM Sales. 


Our price $74.95 (SSPELL) 


Web site: http://www.devdepot.com ® E-mail: orders@devdepot.com 
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B-Tree HELPER™ 2.2 


e Inexpensive database engine for Macintosh programmers 
in C source code. 

e Uses contiguous fixed length blocks. 

e Expands the file as necessary and contracts files when 
possible. 

e Inserts and deletes keys in one or more B- Irees. 

e Finds keys equal to, less than, or greater than a given 
value in a few hundredths of a second. 

e Finds lists of records whose keys are equal to, less than, 
or greater than a given value or are in a range of values. 


Our Price $150.00 (setreg 





Step-Up Installer Pack by StepUp Software 
e Package of several Installer “atoms” that let developers 


ScriptGen Pro by StepUp Software 
e Installer script generator which requires no programming 


incorporate graphics, sounds, file compression and cus- 
tom folder icons into installation scripts. 

e Compression formats supported are Compact Pro & 
Diamond. 

e Each atom also available separately. 

e Compression requires additional licensing. 


or Knowledge of Rez. 


e Supports StepUp’s InstallerPack, Stufflt decompression, 


Compact Pro 
decompression, custom packages, splash screens, net- 
work installs, and resource installation. 


Our price $169.00 (sscrPrcEN) 


Our price $219.00 (sinstaLt) 


NeoAccess™ 


e Full-featured object database engine for use in Macintosh, 
Windows, Unix and DOS based C++ applications. 

e Extended binary trees and binary search algorithms tuned for 
short access times; dynamically combined, collapsed, and 
compressed indices; object caching for instant access to 
previously used objects. 

e Build fast, powerful applications in record time! 


Our price $749.00 (SNEO) 





AppMaker 


e Develop the user interface for a Macintosh application using the original interface builder. 
e Just point and click to design your application. 
e Creates resources and generates excellent source code. 
e Supports most development environments including Metrowerks, Symantec, or MPW; 
C, C++, or Pascal: procedural or object-oriented, using PowerPlant, TCL, or MacApp. 
e The generated code uses the Universal Headers to provide PowerMac compatibility. 
e Great tool for beginners to learn object-oriented and Macintosh Toolbox programming tech- 
niques. 
e Includes one-year subscription on CD. 
List $299.00 Our Price $279.99 (SAPPMAKE 
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PRODUCT 

3D Game Machine 

AdLib 

Animation Class Library 
CLImate 

CMaster 

DataScript 

ICONIX PowerTools-10 Pack 
ICONIX PowerTools-6 Pack 
ICONIX PowerTools-8 Pack 
ICONIX PowerTools-AdaFlow 
ICONIX PowerTools-ASCIl Bridge 
ICONIX PowerTools-CoCoPro 
ICONIX PowerTools-DataModeler 
ICONIX PowerTools-FastTask 
ICONIX PowerTools-FreeFlow 
ICONIX PowerTools-Object Modeler 
ICONIX PowerTools-PowerPDL 
ICONIX PowerTools-QuickChart 
ICONIX PowerTools-SmartChart 
ICONIX Training & Consulting 
IMSL Math and Stat F77 
Info-Mac VIII 

LJ Profiler 

Mac Games II 

Mac Source 

MacA&D Demo 

MacA&D Product 

MacAnalyst Demo 

MacAnalyst Product 
MacAnalyst/Expert Demo 
MacAnalyst/Expert Product 
MacDesigner Demo 
MacDesigner Product 
MacDesigner/Expert Demo 
MacDesigner/Expert Product 
MacScholar 

MacScholar Jr. 

MacWireFrame 

MAScript 

More Savvy 

PowerMac 2 

Professional MachTen for 68k Macs 
Rosanne 

S-Case 

Savvy 

savy QuickTime 

Stonelable for 68K 

StoneTable for PowerPC 

Super Savy 

superPlot 

SuperPlot Pro 

Tenon Ported Applications CD 
Top 10 Pick for Macintosh 
V3d/3dPane/SmartPane 

VText 


CODE 
S3DGAME 
SADLIB 
SACL 
SCLIMATE 


SCMASTER 
SWDSCRIPT 


SICPP10 
SICPP6 
SICPP8 
SICADA 
SICASCII 
SsICCOCO 


SICDATAMOD 
SICFASTTASK 


SICFREEFL 


SICOBJMOD 


SICPOWER 


SICQUICKCH 


SICSMART 
TICONIX 


SIMSLSTAT 
SINFOMAC8 


SLUPROF 


SMACGAMES2 
SMACSOURCE 


SMACADD 
SMACADP 
SMACAND 
SMACANP 


SMACANED 
SMACANEP 
SMACDESD 
SMACDESP 
SMACDESED 
SMACDESEP 
SMACSCHOL 
SMACSCHOLJR 


SFRAM 


SMASCRIPT 


SMORSAV 


SPOWERMAC2 


SPROM10 


SROSANNE 


SSCASE 
SSAVVY 
SSAVVYQT 


SSTONE68 
SSTONEPPC 


SSSAVVY 
SSPLOT 


SSPLOTPRO 


SPORTED 


STOP10PICK 


9Q3 
SVTEXT 


LIST PRICE 


$299.00 
$195.00 
$250.00 
$59.95 
$129.95 
$249.00 
$7995.00 
$5995.00 
$6995.00 
$1495.00 
$1495.00 
$1495.00 
$1495.00 
$1495.00 


$1495.00 
$1495.00 


$1495.00 
$1495.00 
$1495.00 
$3000.00 
$495.00 
$39.95 
$295.00 
$29.95 
$29.95 
$149.00 
$2995.00 
$79.00 
$995.00 
$79.00 
$1595.00 
$79.00 
$995.00 
$79.00 
$1595.00 
$29.95 
$29.95 
$299.00 
$199.00 
$450.00 
$29.95 
$695.00 
$595.00 
$495.00 
$250.00 
$250.00 
$175.00 
$175.00 
$700.00 
$195.00 
$349.00 
$50.00 
$49.95 
$192.00 
$350.00 


| a Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


OUR PRICE 


$299.00 
$195.00 
$250.00 
$59.95 
$129.95 
$229.99 
$7845.00 
$5945.00 
$6945.00 
$1395.00 
$1395.00 
$1395.00 
$1395.00 
$1395.00 
$1395.00 
$1395.00 
$1395.00 
$1395.00 
$1395.00 
$2945.00 
$495.00 
$35.95 
$295.00 
$26.95 
$26.95 
$139.00 
$2895.00 
$74.95 
$945.00 
$74.95 
$1545.00 
$74.95 
$945.00 
$74.95 
$1545.00 
$26.95 
$26.95 
$75.00 
$195.00 
$445.00 
$26.95 
$695.00 
$595.00 
$395.00 
$245.00 
$245.00 
$175.00 
$175.00 
$695.00 
$145.00 
$349.00 
$49.95 
$44.95 
$192.00 
$350.00 


Web site: http://www.devdepot.com @ E-mail: orders@devdepot.com 
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_walt.- 
| There ‘S| _ Here are all of the Inside Macintosh products — half off! For full product 


More: / . / 


~ PRODUCT 
Inside Macintosh: AOCE Applications Interface 
Inside Macintosh: AOCE Service Module 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh: 
Inside Macintosh 
Inside Macintosh: QuickTime 

Inside Macintosh: QuickTime Components 





Inside Macintosh®: CD-ROM by Apple Computer, Inc. 


e More than 25 volumes in electronic form. 


e Includes: QuickKDraw™ GX Library, Macintosh Human Interface 
Guidelines, PowerPC System Software, Macintosh Toolbox Essentials 
and More Macintosh Toolbox, QuickTime and QuickTime Components. 

e Access over 16,000 pages of information with Hypertext linking and 
extensive cross referencing. 


List $99.95 Our Price $49.99 (Bimco) 


Devices 
Files 


Imaging with QuickDraw 
Interapplication Communications 
Macintosh Toolbox Essentials 


Memory 


More Macintosh Toolbox 
Networking 

Operating System Utilities 
Overview 

PowerPC Numerics 

PowerPC System Software 
Processes 

QuickDraw GX Environ. & Utilities 
QuickDraw GX Graphics 
QuickDraw GX Objects 
QuickDraw GX Printing 
QuickDraw GX Printing Extensions 
QuickDraw GX Prog. Overview 

‘ QuickDraw GX Typography 


Inside Macintosh: Sound 
Inside Macintosh: Text 


Inside Macintosh: X-Reference 


CODE 
BIMAOCE 
BIMAOCES 
BIMDEV 
BIMFIL 
BIMIMAG 
BIMIAPP 
BIMTBOX 
BIMMEM 
BIMMAC 
BIMNET 
BIMOPSU 
BIMOVER 
BIMPPCNUM 
BIMPPCSYS 
BIMPROC 
BIMGXENV 
BIMGXGR 
BIMGXOBJ 
BIMGXPRNT 
BIMGXEXT 
BIMGXOV 
BIMGXTYP 
BIMQT 
BIMQTCOM 
BIMSOUND 
BIMTEXT 
BIMXREF 






$44.95 
$29.95 
$29.95 
$29.95 
$32.95 
$36.95 
$39.95 
$24.95 
$34.95 
$29.95 
$28.95 
$24.95 
$28.95 
$24.95 
$22.95 
$31.95 
$31.95 
$31.95 
$29.95 
$29.95 
$24.95 
$29.95 
$29.95 
$34.95 
$29.95 
$39.95 
$19.95 
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descriptions please see our Web site, or feel free to call, fax, or E-mail us. 


LISTPRICE OUR PRICE 


$21.99 
$14.50 
$14.50 
$14.50 
$15.99 
$17.99 
$19.50 
$11.99 
$16.99 
$14.50 
$13.99 
$11.99 
$13.99 
$11.99 
$10.99 
$15.50 
$15.50 
$15.50 
$14.50 
$14.99 
$11.99 
$14.50 
$14.50 
$16.99 
$14.50 
$19.50 
$9.50 
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Programmer’s Toolbox Assistant CD-ROM 
Instant electronic access to Inside Macintosh essentials. 


¢ Get quick access to reference pages for over 4,000 Toolbox calls in your 
system software from their development environment. 

e Essential information for Macintosh software developers. 

e Hypertext links allow programmers to view related topics easily. 

e The ultimate electronic reference tool for Macintosh programmers. 


List $99.95 Our Price STBASST) 


Macintosh Programmer’s 





The Elements 


Order Toll-free of E-Mail Style 
by Brent Heslop and David Angell 
(800-622-338 1] e Write solid, effective E-Mail and 
avoid common pitfalls. 
List $14.95 Our Price BEMAIL 





Hooked on Java 


e Written by the Java development team at Sun. 

e An introduction to using applets, for Web administrators, 
designers, and developers. 

e Demonstrates how to use applets in your own pages. 

e Includes a concise introduction 
to the Java language, and a CD with tools. 


List $29.95 Our Price BHJAVA 





Java in a Nutshell 


¢ A complete quick reference guide to Java, the hot new programming lan- 
guage from SunMicrosystems. 

¢ Contains descriptions of all of the classes in the Java 1.0 API, with a defin- 
itive listing of all methods and variables. 

e Also contains an accelerated introduction to Java for C and C++ program- 
mers who want to learn the language fast. 


List $14.95 Our price BJAVANUT) 
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Web site: http://www.devdepot.com ® E-mail: orders@devdepot.com 
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MANAGING ous 


e The definitive guide to setting up and 
running a Web site on the Macintosh. 

e Learn everything you need to know 
about using WebSTAR, the best known 
HTTP server software and its shareware 
predecessor MacHTTP. 

e Write CGI applications for your server — 
in AppleScript and in C. 

e CD includes a special version of 









0 
WebSTAR, plus tons of useful software. recur ae 
List $39.95 Our Price GES 
% ° 
(BPLANWEB) °Y return © 
clud 
Teach Yourself Java for “aN 


Macintosh in 21 Days 


e Add interactivity and multimedia to Web 














Teace YOURSELF Pag eS ! 
J e Astep-by-step guide to make your Web oe 
ca“inom | site come alive. or Se el rr 
e Learn the basics of programming Java ‘ a. _. 
applets and the concepts behind the Java language. JavaScript for JAVASCRIPT 
e Includes CD-ROM with a limited version of Roaster, the first the Macintosh 22 


commercial, integrated applet development environment for ° Allows non-programmers to take advantage 


Java for the Macintosh! of the power of Netscape Navigator. 
List $40.00 Our price (BJAVAMAC) e Expand the capabilities of your Web page, 
without having to understand C or C++. 
e CD-ROM contains “Wizlets” that allows you 
to easily create your own Javascripts 
e Takes you step-by-step through programming 
cross-platform Javascripts 
e Details how to create JavaScripts for 
JavaScript-aware Web browsers 


List $45.00 Our price (BUAVASCRPTU) 
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Mac OS 8 Revealed by Tony Francis 

e The first authoritative look at this exciting new operating system. 

e A must for Mac developers who want to make their software compatible with Mac OS 
e essential for system administrators who plan to upgrade their system. 

e Included CD-ROM contains demos of new Mac OS 8 features. Re 


List: $34.95 Our Price: (BMACOSS8R) 
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Learn C on The Macintosh Second Edition py Dave mark 


e New revised edition. 

e Easy-to-understand — everything you need to start programming! 

e Updated and enhanced exercises that lead you step by step. You'll learn function, vari- 
ables, pointers datatypes, data structures, file inout and output and more! 

e Includes CD-ROM with Metrowerks CodeWarrior™ Lite — the hottest Macintosh program- 
ming environment (including a PowerPC version). 


List $34.95 Our Price $31.45 (BLEARNC2) 
SEE RELATED CATEGORY: Dev. Environments 





CodeWarrior Software Development Using PowerPlant 


by Jan L. Harrington 

e C++ programmers will learn to develop object-oriented software applications for the 
Mac and Power Mac using the PowerPlant environment and the classes that support it. 
e Covers CodeWarrior 8. © Included CD-ROM contains source code for all the program- 
ming examples in the book and Metrowerks CodeWarrior Lite. 


List Price: $34.95 Our Price: $31.45 (BCWSWDEV) 


Designing Animation for the Web from Hayden Development Team 

e Provides technical information and design advice for creating animation on the web 

e Expert tios show which technology to use for specific needs: GIF animation, Shockwave, Java and more. 
e Covers bandwidth considerations and the integration of animations into overall site design. 

e Step-by-step instructions. 

e CD-ROM includes tools, scripts, and examples for creating animations. 


List $40.00 Our Price $36.00 (BDAFTW) 


CGI By Example by Jeffrey Dwight Perl Quick Reference by Michael 0. Foghtu 

e CD-ROM contains all the code and tools used in the e Commands are sorted by task, class packet, platform or 
book, and additional tools and examples, as well as hardware compatability all in alphabetical order 
related chapters from Special Edition Using CGI and e Includes jump tables to guide reader to specific pages in 
special Edition JavaScript the reference 

e Includes end of the chapter review questions and e Designed in a larger trim size than traditional Quick 
exercises to reinforce the learning process References-and with a lay-flat binding 

¢ Covers basic CGI applications, as well as advanced List $19.99 Our Price $17.99 (BPERLRER) 
topics like server administration issues and database 
connectivity 


List $34.99 Our Price $31.45 (sciBe) 


Optimizing PowerPC Code: 
Programming the PowerPC in 


Assembly Language 


e Jake full advantage of the potential of the PowerPC by mas- 
tering the Assembly Language techniques. 
e Learn to produce faster more robust software! 


List $39.95 Our Price $35.96 @oprtprc) 
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Macintosh C Programming Primer Volume | 
Second Edition, Inside the Toolbox Using THINK C by Dave Mark and Cartwright Reed 


e Updated new edition of the Macintosh programming best seller. 

e System 7, new versions of THINK C and ResEdit. 

e Learn how to use the resources, Macintosh Toolbox and interface to create stand-alone application: 
e 6/2 pages. 


List $26.95 Our Price (BCPRIM1) 


Macintosh C Programming Primer Volume Il 
Mastering the Toolbox Using THINK C by Dave Mark. 


e Covers advanced topics such as: Color QuickDraw, THINK Class Library, TextEdit, and the 
Memory Manager: 528 pgs. 


List $26.95 Our Price (BCPRIM2) 





Learn G++ on the Macintosh by Dave Mark. 
e Basic syntax of C++ and object programming. 
e Learn how to write, edit, and compile your first C++ programs. 
e Features key C++ concepts such as derived classes, operator overloading, iostream functions and more. 
e Includes a special version of Symantec C++ for Macintosh. Book/disk package with 3.5" 800K Macintosh 
disk. 400 pages. 
List $36.95 Our Price (BLRNCPP) 
SEE RELATED CATEGORY: Dev. Environments 


Macintosh Pascal Programming Primer Volume | 
Inside the Toolbox Using THINK Pascal by Dave Mark and Cartwright Reed. 


This tutorial shows programmers new to the Macintosh how to use the Toolbox, 
resources, and the Macintosh interface to create stand-alone applications with 
symantec’s THINK Pascal. 544 pages. 


List $26.95 Our Price (BPASCPRI) 





Power Macintosh Programming Starter Kit 
by Tom Thompson. 


e Enter the world of the PowerPC chips. 

e Get the scoop on the microprocessors, the RISC architecture, and how to write 
native code and emulation operations to create software for the Macintosh PowerPC. 

e CD-ROM includes a unique compiler for writing code easily. Wud 


List $39.95 Our Price (BPPCSTART) 
SEE RELATED CATEGORY: Dev. Environments 





Macintosh Programming Secrets 2nd edition 
By Scott Knaster, and Keith Rollin 


e Macintosh Programming Secrets is divided in two parts. 
Order Toll-free Part 1: “Concepts and Ideas”, discusses the evolution of the Macintosh and the standards, 
customs, and software that shape the system as well as the Macintosh user interface. 
Part 2: “Technical Adventures”, presents the skeleton of an application, and then builds upon 
that framework to describe how to: © Create fancy dialogue boxes ¢ Utilize the new 32 bit 
QuickDraw developments e Track the mouse with “marching ants” « Manage multiple windows 
with the Window manager ¢ Copy files within a program e Install the worlds 
strangest spinning cursor. 


List $31.95 Our Price (BPSECRET) 


(800-622-338 1] 


1-800-MACDEV-1 ¢ Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 
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Cyberdog Programmers Kit by Apple Computer, Inc. 


e Apple's official reference. 

e A must for developers who want to make customizable Internet access available 
to all Mac users. 

e Included CD-ROM contains all the tools needed to create Cyberdog-aware 
components. 


List: $39.95 Our Price: $34.95 (@cyBERDOG) 


AA SAL 


Cyberdog Programmer’ 





A Fragment of Your Imagination by Joe Zobkiw 


e Packed with useful code fragments for the Macintosh and Power Macintosh. 

e Hard to find information about techniques used to structure and build fat, safe fat, 
and accelerated code resources. 

e All code is reusable and is provided on the disc, along with 
Metrowerks 
Code Warrior Lite. Book/CD-ROM, 528 pages. 


List $39.95 Our Price $35.96 (FRAG) 





Programming with AppleTalk by Michael Pierce 

e Programming with AppleTalk is the hands-on guide to understand- 
ing and working with AppleTalk. Topics covered include: 

e How to create applications and system extensions that run with 


Cc 
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: AppleTalk. yw 
Java Language API SuperBible e AppleTalk protocols and the protocol stack, transport media, the ae 
by Daniel Groner, Todd Sundtsed, Casey Hopson, Harish Preferred Applelalk Intefrace, and the storage management. 
Prabandham e Numerous working code examples walk you through using RDEV, ae 
e Covers Java 1.1 INIT, NBP, ATP, and ADSP. You will also learn the use of: Vw 
e Hundreds of concrete source code examples provided Synchronous, and asynchronous calls, How to avoid heap frag- = 
e Sample projects introduced and assembled in each chapter mentation, And how to configure a Chooser Interface. as] 
List $59.99 Our price $53.99 (BuLAs) List $24.95 Our Price $22.45 (BPROAT aan 
Jia 
eet 
— 
NetObjects Fusion Handbook Infini-D Revealed i... 
from Hayden Development Team — by Brendan Donahoe & Adam Lavine os 
e Create Web pages and Sites through design techniques ¢ CD-ROM includes a demo version of Infini-D 6 9} 
developed by Clement Mok’s design agency. 3.1, files for working through the tutorials, ot 


and a gallery of spectacular 3D images 

e Shows how to use the new animation fea- 
tures to bring images to life 

e Details Infini-D’s new and improved color- 
coded interface 


List $45.00 Our price $40.50 (sineDREV) 


e Step-by-step instructions on updating sites with links 
and navigational controls automatically. 

e Outlines the comprehensive steps to delivering an auto- 
mated, turnkey Web publishing solution. 

e CD-ROM contains a 45 day time-limited version of 
NetObjects Fusion. 


List $50.00 Our Price $45.00 (BNeETOFH) 


0; 


RC 





Web site: htto://www.devdepot.com ® E-mail: orders@devdepot.com 





pa anata makina nas mae pieNe > Sredz Hck oer Sil ign ONSHORE EMINEM eRe tit aR eRAGOT LE yagstatOS € sgn eei ae angie oRpamemianu pRpmMCR mu Ratt a 


iw 


Be z 
% 
3 : 
? 
eA 
74 
\ 
Ee 
4 eo 
fare Be 
: = 
‘ i : : 
Fi 7 ? i 
: : 
f 
: é 
t 3 rs ¢ J ; 
; hy, 
at ba sense aes & 
iy : 
i 
a 


| 
y 


ngua 


AppleScript AppleScript AppleScript 


Finder G Scriptin ions Guide 









AppleScript Language Guide, 
by Apple Computer, Inc. 


e A complete reference for anyone using AppleScript to modify existing 
scripts or to write new ones. 

e Contains useful information for programmers who are working on 
scriptable applications or complex scripts. 

e Features detailed definitions of AppleScript terminology and syntax in 
the following categories: Value classes, commands, objects and ref- 
erences to objects, expressions, control statements, handlers, and 
script objects. 

e Includes many sample scripts, discusses advanced topics such as 
writing command handlers for script applications, the scope of script 
variables and properties declared at different levels in a script, and 
inheritance and delegation among script objects. 


List $29.95 Our Price (BALG) 
SEE RELATED CATEGORY: Scripting 


GOODMAN'S 





AppleScript Finder Guide, 


English Dialect by Apple Computer, Inc. 


e Provides definitions for Finder object classes 
and commands. 

e Write, record, or run scripts that trigger the 
same desktop actions that you trigger using the 
keyboard and mouse. 

List $19.95 Our Price (BAFG) 
SEE RELATED CATEGORY: Scripting 


AppleScript Scripting 
Additions Guide by Apple Computer, Inc. 


e Use the standard scripting additions commands. 
e Write scripting additions. 

List $18.95 Our Price 

SEE RELATED CATEGORY: Scripting 


(BSCRADD) 


Danny Goodman’s AppleScript Handbook 
Second Edition by Danny Goodman 


e Customize and extend the capabilities of any Macintosh computer — no 
programming experience needed! 

e Learn to use scripts to enhance the Macintosh environment, automate many 
processes, link data between applications, and much more. 

e All-new examples showing how to integrate AppleScript with the Finder, 
spreadsheets, desktop publishing programs, graphics applications, databases, 
telecommunications programs, utilities, and HyperCard. 

e Includes 3 1/2" disk with over $100 worth of software, including 
Applescript 1.1, valuable utilities, and powerful, ready-to-use scripts. 


List $39.00 Our Price (BDGASHB) 
SEE RELATED CATEGORY: Scripting, Tools, Libs & Utilities 


: 


2nd Edition 





e Harness the capabilities of a wide variety of Macintosh 
applications into the integrated productivity tools. This 
includes such things as the newspaper script which com- 
bines the power of SlTcomm, MacWrite Pro, and FileMaker 
Pro, or QuarkXPress. 


List $34.95 Our Price 
SEE RELATED CATEGORY: Scripting 


Applied Mac Scripting 


e Learn to design and develop powerful scripts. 

e Covers AppleScript™ , Frontier, QuicKeys, Tempo Il, nShell, 
FaceSpan Application Builder, Scripting PlainTalk and System 
(2, 

e Hands on tutorial shows you how to automate your 
Macintosh activities by learning how to use the AppleScript 
and Frontier scripting environments. 


BOOKS AND BEFERI 


(BAPPLIED) 
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PowerPC Programmer’s Toolkit by Tom Thompson 


e CD-ROM includes a special version of Metrowerks CodeWarrior 7.0 and sample code from 
the book 

e Details how to write PowerPC applications in native code for blazing speed eceie 

e Written by an Apple Insider ade 
List $45.00 Our Price (SPPCPT) ) _ 





Network Frontiers Bundle 

by AP PROFESSIONAL 

(Includes 3 books: Complete Guide to 

MAC, Backup Management, Designing AppleTalk 
Network Architectures, Managing AppleShare 
and Workgroup Servers) 


Mastering Netscape 4.0 for Macintosh, Second 
Edition by Greg Holden 
e CD-ROM includes Netscape Plug-Ins and helper applications 
e Uncovers hidden features of the program and how to best utilize them 
e Web page for the book includes cool utilities and updated information 
List $40.00 Our Price (SMASNET4) 
e Apple Certified 
e Each bundle includes the first 3 books 
a. that correspond to the Apple 
= , ) | | e Certified Server Engineer (ACSE) program 


List $89.95 Our Price (BNETFB) 





(call for details) dam 


Object Oriented Program Design by Mark Mullin 

e A concise guide to the essential concepts and techniques of OOP design 

e Clarifies the key concepts of object oriented programming such as objects, classes, 
entities, hierarchies, and inheritance 

e Uses typical database application to illustrate each OOP topic, to give the programmer a 
familiar point of reference 


List $22.95 Our Price (BOOPRODES) 


DeBabelizer: The Authorized 


Edition from Hayden Development Team 

e Teaches effective ways to utilize DeBabelizer to 
improve graphic’s quality and speed. 

e Offers techniques for using SuperPallette to opti- 
mize images. 

e Provides extensive visual examples to illustrate key 
production techniques in all areas of graphics pro- 





Intranet Web Development: Enterprise Alternatives to 

Client/Server Computing from Hayden Development Team 

e Learn why traditional client/server computing is being replaced by new 
WWW technologies. 

e Discusses WWW application development with the Microsoft Visual 
Script enterprise application developer in mind. 

e Learn techniques for the conversion of existing Visual Basic, C++ and 
PowerBuilder Appiications to the new WWW platform. 


; cessing. 
List $49.99 Our Price (BINTWD) e CD-ROM includes the Lite version as well as 
Photoshop plug-ins. 
List $45.00 Our Price (BDEBTAE) 


Tog on Software Design 

by Bruce “Tog” Tognazzini 

Respected industry futurist, Tog, presents his vision of our technological 
future, detailing the steps computer professionals need to take to deliv- 
er new technologies that will profit the industry and benefit society in 
general. Contains Tog’s insights on a wide range of topics from quality 
management to the meaning of standards, and responses to queries 
supplied by designers and developers. 


List $29.95 Our Price (BTOG) 
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3D Graphics Programming Using 


QuickDraw 3D 
by Apple Computer, Inc. 


e Incorporate spectacular 3D graphics into your applications. 

e Explore QuickDraw 3D, a revolutionary graphics extension to the Mac 
OS for Power Macintoshes. 

e CD contains the complete QuickDraw 3D system itself and a com- 
plete database of the QuickDraw 3D API, allowing you instant 
access to the hundreds of graphics calls via a fast viewing engine. 
Book/CD-ROM, 640 pages. 


List $39.95 Our Price (B3DGRAP) 






Sex, Lies and Video Games by Bill Hensler 
e A learn-by-example tutorial on the ins and outs of Mac arcade-style game 
programming in C. : 
e Features game theory, sprite animation, sound, and interaction techniques. . | 
e A must-read for serious programmer's and hobbyists alike. | Lies 
List 34.95 Our Price (BSEX) c| 
SEE RELATED CATEGORY: Tools, Libs & Utilities Vide 3 Wes | 
Mew wie Mudosle Atal Game. 
Bll tenee 
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Tricks of The Mac Game Programming Gurus 


e For beginning to expert game programmers 

e Complete overview of all the necessary components of game programming on the 
Macintosh. 

e Packed with valuable tools, utilities, sample code, CodeWarrior™ Lite and game demos. 

e QuickDraw 3D and Power Mac optimization and inside info on how Glypha Ill was created. 

e Hundreds of tried-and-true tricks, tips, and insider secrets from well-known Mac game 
programming experts 


List $50.00 Our Price (BTRICKS) 
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Black Art of 


Black Art of Macintosh Game Programming: oe 4 
by Kevin Tieskoetter MACINTOSH | 
e Develop your own 3D games in C on the Mac. . GAME 

e Includes CD with project files for both Symantec C and Code Warrior » PROGRAMMING | 

e Create freeform texture-mapped games and polygon graphics Ce We f 
e Control dynamic source code-all compatible as native to the Power Mac a ay 

e Write directly to the screen, bypassing QuickDraw | & i 


List $39.99 Our price (BBLACK) 


The groundbreaking guide to writing 
sfew 


profe al 3D war & Macintosh, 
featuring unprecedented demonstrations 
of freeform texture-mapping. 


y 
Ld 
¢, 
lla 
hoa 
~ 
aca 
ls 
—Vwt 
re 
ee 
fix 
as 
| 
a 








NS 


1-800-MACDEV-1 © Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 





RAPHICS GEMS Graphic Gems V Edited by Alan W. Paeth 


EDITED ay PAUL'S. HECKEERT e Loaded with practical tools for implementing new ideas and techniques, to offer working 

solutions to real programming problems. 

e Contains over 40 new gems in ellipses, splines, Bezier curves, and ray tracing — displaying 
the most recent and innovative 
techniques in graphics programming. 

e Includes a disk with source code from all five volumes. Available in both IBM and Macintosh 
versions. CONTENTS: Algebra and Arithmetic. Computational Geometry. Modeling and 
Transformation. Curves and Surfaces. Ray Tracing and 
Radiosity. Halftoning and Image Processing. Utilities. 


List $49.95 Our Price (BGEMS5) 





Advanced Color Imaging on the Mac 0S 


e Enhance your software’s color capabilities with step-by-step instructions. 

e Augment the color support supplied with QuickDraw, and QuickDraw GX. 

e Use the Pallette Manager to get the best colors on limited displays. 

e Match colors between screens and input/output devices (scanners & printers) 

e CD includes a complete reference information in both QuickView and Acrobat formats. 
Plus, a sample application demonstrating ColorSync programming techniques. 


List $36.95 Our Price (BADVCI) 
ecllde 
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OpenDoc Programmer’s Cookbook 
e Shows you how to create OpenDoc software components, called parts editors, for the Mac OS 





Platform. i jaa 
e Including instructions for setting up the Macintosh Programmers Workshop (MPW) development L we 
environment to write OpenDoc software i | 
e Annotated listings of explaining the methods that implement the SamplePart part editor ' (i 
e Descriptions of other sample part editors created by the OpenDoc engineering team to illustrate | _. aa 
more advanced features gieed 
e Summary descriptions of software utilities provided with OpenDoc for the Mac OS / 7 
e An Introduction to the System Object Model (SOM) technology underlying OpenDoc | (pul 
List $24.95 Our price (BODCOOK) re 
wt 


Inside PowerPlant Manual 


e Create PowerPlant applications using the 
CodeWarrior IDE and PowerPlant Constructor. 

e Full descriptions of major PowerPlant classes and 
reSOUrces. 

e Included are the PowerPlant Constructor Manual, 


ResEdit Complete, 
Second Edition 
by Peter Alley and Carolyn Strange 


e Customize every aspect of your interface form 
creating screen backgrounds and icons to cus- 
tomizing menus and dialog boxes. 608 pages. 


KS AND RE 





including View, TextTraits and Custom Types edit- ) cia 
Book/disk package. ) 

ing, and PowerPlant Library Reference, covering . ane d . cnn 
all classes and functions in PowerPlant. List $34.95 Our Price pres > , 
Our Price (BINSPP) Dray 
SEE RELATED CATEGORY: Dev. Environment | ( a 
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C++ Programming with CodeWarrior 

by Jan L. Harrington 

e Beginning OOP for the Macintosh and Power Macintosh and Mac OS 
compatibles. 

e Learn object-oriented programming techniques using C++ as the exam- 
ple language and Metrowerks and CodeWarrior as the example compiler. 

e Enclosed CD contains example code from the book and a full-function 
Metrowerks CodeWarrior 


List $35.95 Our Price $32.35 (ecppcw) 






OpenDoc Programmer’s Guide by Apple Computer, Inc. 

e The official reference for the implementation of OpenDoc on the Mac OS. ¢ Describes the component software revo- 
lution and explains how to develop for it on the Mac OS platform. # Accompanying CD-ROM contains a complete refer- 
ence to the OpenDoc programming interface, and an extensive collection of tested, reusable sample code. 


List $44.95 Our Price $40.46 @openpoc) 


The ResEdit All Night Diner by David Ciskowski 


e An idea-filled menu and introduction to the joys of customizing software. 

e Add personality to the Mac by customizing default icons, the text of menus and dialog 
boxes, cursors, pointers and more. 

e Disk features ResEdit, plus lots of sample resources 


List $24.95 Our Price $22.45 (BRESDINE) 
SEE RELATED CATEGORY: Dev. Environments 
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ww C++ Programming with MacApp 
Sf, | by David Wilson, Larry Rosenstein & Dan Shafer 
Vwi e | earn the secrets to unlocking the power of MacApp®, Apple’s development envi- 
aot ronment for C++ 
e Learn to design complex windows and views using the ViewEdit tool 
wt | e Learn to support multipage text and graphics with only five lines of code 
iam | Lape 
 \ e Learn to support Undo for menu commands and drawing operations that use the 
in mouse. 
iw 
a List $34.95 Our Price $31.46 (ecpPmacap) DAVID A. WILSON 
a \ SEE RELATED CATEGORY: Tools, Libs & Utilities no DAN SHAFER 
ite, 
ia 
gr ‘ ‘s ‘ 
MG Essential OpenDoc Inside CodeWarrior 9 
ot \ e Gives an in-depth look at the technical issues of OpenDoc e Includes CodeWarrior IDE User’s Guide. 
e Explores the three core technologies that support it’s e This is the printed version of the documentation provided 
s functionality - SOM, OpenDoc’s storage mechanism, and on the CD. 
naga ‘ the Open Scripting Architecture (OSA). e Covers CodeWarrior, the debugger, and associated tools. 
ad e Also examines CyberDog, a set of OpenDoc part editors that ; 
\ Our Price ‘ (BINSCW) 
fm * provides access to Internet services and offers compelling SEE RELATED CATEGORY: Dev. Environment 
war’ 
r< example of the power of OpenDoc development 
— List $39.95 Our price $35.95 (esop) 
: a | 
pom | 
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Metrowerks CodeWarrior Programming by Dan Parks Sydow 


e Includes CodeWarrior Lite, and Full Coverage of PowerPlant™. 
e The best information on Metrowerks CodeWarrior, giving full coverage to the Gold Edition. 
e CD includes Code Warrior Lite. 


List $39.95 Our Price $35.95 (cweRroG) 





Visual Programming with Prograph CPX 


by Scott B. Steinman and Kevin G. Carver 


e An introduction to the language and a guide for advanced users, for both 
Macintosh and Windows-based machines. 
List $34.00 Our Price $30.60 @vispro) 
SEE RELATED CATEGORY: Dev. Environments 


Dan Shafer Presents the Power of Prograph CPX 

e Master the revolutionary graphical object-oriented programming language. 

e Step by step course through three interrelated projects of increasing complexity. 
e Learn Prograph language, CPX classes and object editors. 

e Includes disk with all code in the book. 


List $49.95 Our Price $19.95 (BDANPRO) 





Mastering the THINK Class Library 


by Richard Parker 

e Provides a thorough examination of Symantec’s extensive Class Library and the 
Visual Architect. 

e A complete description of the structure and operation of the TCL includes explanations 
of all code generated by the Visual Architect, any necessary custom code, and the 
operation of this code. 

e Visual Architect tutorials provide you with a step-by-step approach for simplifying the 
development of complex Macintosh applications. 496 pages. 


List $29.95 Our Price $26.95 (BMASTERTCL) 
SEE RELATED CATEGORY: Dev. Environments 
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Danny Goodman’s Apple Guide Starter Kit 


by Danny Goodman and Jeremy Joan Hewes. 


e Create your own Apple Guide databases quickly and easily, without having to learn a 
scripting language, write coded files, or use several different files and programs 

e Includes advice and tips on how to design a good Guide, from planning and creation 
through testing, revising, and indexing. Book/disk, 320 pages. 


List $34.95 Our Price $31.46 (epcacsk) 
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MacsBug Reference & Debugging Guide For MacsBug version 6.2 
by Apple Computer, Inc. 


e MacsBug is an assembly-language-level debugging tool « Macros, templates, dcmds, and other resources for 
making debugging easier ¢ Macintosh memory management and the operating system as they relate to low level 
debugging ¢ How to display and set memory and process registers ¢ Disassemble memory, and set execution 
breakpoints ¢ Discipline, a tool for testing the validity of toolbox parameters ¢ Debugging strategies you can use to 
find and cure common bugs Includes MacsBug 6.2. 


List $34.95 Our Price $31.46 (@BUGREF) 
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AppleGuide Complete 
by Apple Computer, Inc. 


e Covers Guide Maker, the software you use to build and test guide files. 
e Learn about the complete cycle of designing as well as advanced top- 
ics such as scripting and coding guide files. Book/CD-ROM, 544 
pages. 
List $39.95 Our Price $35.96 @apiep) 
SEE RELATED CATEGORY: Tools, Libs & Utilities 






Programming For The Newton: Software 


Development using NewtonScript 
by Julie McKeehan and Neil Rhodes. Foreword by Walter R. Smith 


e An indispensable tool for Newton programmers. ¢ Includes disk with sample Newton application from the books, as well as 

demonstration version of Newton Toolkit (NTK) — the complete development environment for the Newton®, ¢ A Publication of 

AP Professional May 1994, Paperback, 393 pp. 
List $29.95 Our Price $26.95 (ePROGNEWn) 
SEE RELATED CATEGORY: Dev. Environments 


AppleScript Applications: Building 
Applications with FaceSpan and 


AppleScript 
BASIC for the Newton Using by John Schettino Affiliation & Liz O’Hara 
by John Schettino & Liz O’Hara ¢ Build complete AppleScript applications using FaceSpan, a 


user interface development tool that makes AppleScript appli- 
cations truly “Mac-Like” ¢ Uses a step-by step approach to 
demonstrate techniques for building applications through illus- 
trations and samples ¢ Provides Graphical User Interface (GUI) 
design tips and practical approaches for implementation e 
Contains one CD-Rom with AppleScript 1.1, a demonstrations 
version of FaceSpan 2.1, source code for all example applica- 
tions numerous AppleScript shareware and demonstrations 
programs ¢ Contains a section on debugging AppleScript 
applications using FaceSpan 


List $34.95 Our Price $31.00 (BAPSCAP) 


e Program on Macintosh, Windows-based PC, or on the 
Newton itself, 

e Straight-forward “programming by example” approach 
— you'll be writing Newton programs right away. 

e Includes 3.5" disk containing Demonstration NS BASIC 
and over fifty example programs. (Newton not included) 


List $35.95 Our Price $32.35 (NnEwn 
SEE RELATED CATEGORY: Dev. Environments 
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Netscape Navigator Starter Kit for Macintosh 5y Macwilan 
¢ Create your own home page in minutes and add hyperlinks to your favorite Web sites 
e Add graphics, audio, and video 

e Download files via FTP 

e Load plug-ins to enable movies, audio, animations, and more 


List $34.99 Our Price $31.49 (BNETNSK) 
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Web Page Scripting Techniques by Macwillan 


e Manipulating color effectively 

e Placing images and using shapes 

e Using JavaScript functions and objects, plus VBScript functions and objects 
e Determining users’ browser type and operating system 
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Internet Publishing with Adobe Acrobat 

by MacMillan 

e Optimizing PDF for Web viewing, integrating HTML and PDF, 
selecting PDF page dimensions, PDF file evaluation 

e Setting links to PDFs and URLs, PDF forms, Security algorithms, 
Configuring Web servers for PDF, Embedded PDFs, PDF creation 
techniques. 


List $40.00 Our Price $36.00 (@ipwaAd) 
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Wireless For The Newton: Software 


Development for Mobile Communications 
by Julie McKeehan and Neil Rhodes 


e Learn to develop Newton® software on the Macintosh. 

e Hands-on Newton environment training with sample code 

e Includes disk with sample source code for a Newton application, 
as well as demonstration NTK™ — the complete development 
environment for the Newton®. 


List $34.95 Our Price $31.45 (BwiRELess) 
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Learn Java on the Mac 
by Barry Boone with Dave Mark 


e Easy-to-follow introduction for beginning programmers and Webmasters. 

e Takes you through the core concepts of Java. 

e Includes: Object-oriented techniques, unique features such as garbage collection, 
and basic programming concepts such as working with variables, threads and 
classes. 

e Learn to apply this knowledge to write original Java applets for Web pages. 

e Includes CD-ROM 


List: $34.95 Our Price: $31 5 LAVA). 
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Learn HTML on the Mac 


by Dave Mark and David Lawrence 
© 

e Shows you how to use HTML 3.0. -RO 

e Included CD-ROM contains Macintosh tools to design Providing Internet Services 


stunning multimedia Web pages. via the Mac 0S 
List: $29.95 Our Price: $26.95 (HTML) by Carl Steadman and Jason Snell 


e Shows you how to provide Web pages, FTP, Gopher, e-mail, 
and more with the Mac OS. 

e Includes CD-ROM containing all the Mac server software 
and utilities you need. 
List: $34.95 


Our Price: $31.46 (PROVNET). 
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Web site: htto://www.devdepot.com @ E-mail: orders@devdepot.com 










_ Here are more products. For full product descriptions please see our Web 
Site, or feel free to call, fax, or E-mail us. 





PRODUCT CODE LISTPRICE OUR PRICE 
Development Environments 
AppleScript Applications: Building Applications w/FaceSpan BAPSCAP $34.95 $31.45 
Basic for the Newton - Programming using NS BASIC BNEWT $35.95 $32.35 
C++ Programming with CodeWarrior BCPPCW $35.95 $32.35 
C++ Programming with MacApp BCPPMACAP $34.95 $31.46 
C/C++ SDK User’s Guide BCPPUSER $35.00 $29.00 
CodeWarrior Inside PowerPlant BINSPP $34.95 $34.95 
CodeWarrior Software Development using PowerPlant — BCWSWDEV $34.95 $31.45 
Dan Shafer Presents the Power of Prograph CPX BDANPRO $49.95 $19.95 
FORTRAN SDK User’s Guide BFORTUSER $34.95 $34.95 
Inside CodeWarrior Book BINSCW $34.95 $34.95 
Last Resort Programmers Edition BLSTRSRT $74.95 $74.95 
Learn C on the Macintosh, 2nd Edition BLEARNC2 $34.95 $31.45 
Mastering the Think Class Library BMASTERTCL $29.95 $26.95 
Metrowerks CodeWarrior Programming BCWPROG $39.95 $35.95 
Presenting Magic Cap BPRESMAGIC $16.95 $15.25 
Programming for the Newton Using NewtonScript BPROGNEWT $29.95 $26.95 
Programming in Symantec C++ for the Macintosh BPSYMCPP $29.95 $26.95 
Real World Apple Guide BREALWLD $39.95 $35.95 
Symantec C++ Programming BSYMCPP $45.00 $39.50 
Taligent’s Guide to Designing Programs BTALIGENT $19.50 $17.55 
Visual Programming with Prograph BVISPRO $34.00 $30.60 
\ Hardware 
aa Apple CD-ROM Handbook BCDHAND $15.95 $14.36 
rN Designing Cards & Drivers for the Macintosh BCARD $29.95 $26.96 
ww LaserWriter Reference BLASERREF $19.95 $17.96 
aS, \ PCI System Architecture 3rd Edition BPCISYS $34.95 $31.46 
ror \ PowerPC System Architecture BPPCARCH $34.95 $31.46 
am 
: nw Internet Related 
Vv | 1994 Internet White Pages BO4WHITE $29.95 $26.95 
ae \ Active Java BACTJAVA $25.95 $23.36 
a America Online for Dummies BAOLDUM $19.95 $17.95 
r~% CGI By Example BCGIBE $34.99 $31.45 
ag Computer Privacy Handbook BPRIV $24.95 $22.45 
nw \ E-Mail Essentials BEMAILE $24.95 $22.45 
= | Elements of E-Mail Style BEMAIL $14.95 $13.45 
fin, Hooked on Java BHJAVA $29.95 $26.95 
ia Instant Internet Guide BINSTANT $14.95 $13.45 
aS, Internet Book BTHENET $24.99 $22.50 
- \ Internet for Dummies 2nd Edition BNETDUM2 $19.95 $17.99 
my | Internet for Dummies Quick Reference BDUMQCK $8.95 $8.05 
Internet for Macs for Dummies BNETDUM $19.95 $17.95 
6 Internet Power Tools BPWRTOOL $40.00 $36.00 
gel | Internet Publishing with Adobe Acrobat BIPWAA $40.00 $36.00 
a \ Internet Secrets BSECRET $39.99 $35.99 
am Internet, The, Deluxe Edition BNETDELUX $34.99 $31.50 
dl Intranet Web Dev.: Enterprise Alternatives to Client/Server BINTWD $49.99 $44.99 
: _ Java Essentials for C/C++ Programmers BJAVAESSEN $19.95 $17.95 
air \ Java in a Nutshell BJAVANUT $14.95 $13.45 
pom | Java Language AP! SuperBible BULAS $59.99 $53.99 
2 JavaScript for Macintosh BJAVASCRPT $45.00 $40.50 
Learn HTML on the Macintosh BLHTML $29.95 $26.95 
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Learn Java on the Macintosh 
Mastering Netscape 4.0 for Macintosh, Second Edition 
More Internet for Dummies Starter Kit 
Mosaic for Dummies 

Net Chat 

NetObjects Fusion Handbook 
Netscape Navigator 

Netscape Navigator Starter Kit 

Perl Quick Reference 

Planning and Managing Web sites 
Providing Internet Services 

Publish it on the Web 

TCP/IP Vol 1-Vol 2 Bundle 

Teach Yourself Java in 21 days 
Underground Guide to Telecommuting 
Web Head Mac Guide 

Web Page Scripting Techniques 

Web Weaving 

Webmaster Macintosh 


scripting and Solutions 


AppleScript Applications: Building Apps with FaceSpan 
Applied Macintosh Scripting 

Complete AppleScript Handbook 

Complete HyperCard 2.2 Handbook 

Danny Goodman’s Apple Guide Starter Kit 

Danny Goodman’s AppleScript Handbook 

HyperCard Stack Design 

HyperTalk 2.2: The Book 

JavaScript for Macintosh 

Perl Quick Reference 

Real World Apple Guide 

Tao of AppleScript: BMUG’s Guide to Macintosh Scripting 


Technical Reference 


3D Starter Kit 

Active Java 

Apple CD-ROM Handbook 

Art of Human Interface Design 

Black Art of Mac Game Programming 

C++ for Dummies 

C for Dummies Vol. 1 

Developing Object Oriented Software for the Macintosh 
Essential OpenDoc 

Foundations of Macintosh Programming 
Fragment of Your Imagination 

Guide to Macintosh Software Localization 

Guide to Macintosh System 7.5 

How to Write Macintosh Software 

Inside AppleTalk 

Inside the Macintosh Communications Toolbox 
LaserWriter Reference : 
Learn C++ on the Macintosh 

Learn C on the Macintosh, 1st Edition 

Learn C on the Macintosh, 2nd Edition 

Mac Programming for Dummies 

Macintosh C Programmer Primer Volume 1 
Macintosh C Programmer Primer Volume 2 
Macintosh OLE2 Prog. Reference Working with Objects 
Macintosh Pascal Programming Primer Volume | 
Macintosh Programming Secrets 
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BLJAVA 
BMASNET4 
BDUMNET 
BMOSDUM 
BNETCHAT 
BNETOFH 
BNETNAV 
BNETNSK 
BPERLREF 
BPLANWEB 
BPROVNET 
BWEBPUB 
BTCP12BNDL 
BJAVAMAC 
BUNDER 
BWEBHEAD 
BWEBPST 
BWWEAV 
BWEBMAS 


BAPSCAP 
BAPPLIED 
BAPLSCRHB 
BHYPCRD2 
BDGAGSK 
BDGASHB 
BHYPSTA 
BHYPTAL 
BUAVASCRPT 
BPERLREF 
BREALWLD 
BIAO 


B3DSTART 
BACTJAVA 
BCDHAND 
BAHID 
BBLACK 
BCPPDUM 
BCDUM 
BDEVOB 
BESOD 
BFOUND 
BFRAG 
BLOCALIZ 
BSYS7.5 
BWRITE 
BAPTALK 
BCOMM 
BLASERREF 
BLRNCPP 
BLEARNC1 
BLEARNC2 
BMACDUM 
BCPRIM1 
BCPRIM2 
BOLE2 
BPASCPRI 
BPSECRET 


$34.95 
$40.00 
$19.95 
$19.95 
$19.00 
$50.00 
$29.95 
$34.99 
$19.99 
$39.95 
$34.95 
$34.95 


$109.95 


$40.00 
$24.95 
$24.95 
$50.00 
$24.95 
$29.95 


$34.95 
$34.95 
$35.00 
$35.00 
$34.95 
$39.00 
$21.95 
$35.00 
$45.00 
$19.99 
$39.95 
$29.95 


$40.00 
$25.95 
$15.95 
$32.95 
$39.99 
$19.95 
$19.95 
$28.95 
$39.95 
$39.99 
$39.95 
$26.95 
$25.00 
$28.95 
$34.95 
$24.95 
$19.95 
$36.95 
$34.00 
$34.95 
$19.95 
$26.95 
$26.95 
$44.95 
$26.95 
$31.95 


$31.45 
$36.00 
$17.95 
$17.99 
$17.00 
$45.00 
$26.95 
$31.49 
$17.99 
$35.96 
$31.46 
$31.46 
$99.00 
$36.00 
$22.45 
$22.45 
$45.00 
$22.45 
$26.95 


$31.45 
$31.45 
$31.50 
$31.50 
$31.46 
$35.00 
$19.95 
$31.50 
$40.50 
$17.99 
$35.95 
$26.95 


$36.00 
$23.36 
$14.36 
$29.65 
$35.99 
$17.95 
$17.95 
$26.06 
$35.95 
$35.96 
$35.96 
$24.26 
$22.50 
$26.05 
$31.45 
$22.45 
$17.96 
$33.26 
$31.45 
$31.45 
$17.95 
$24.25 
$24.25 
$40.45 
$24.25 
$28.76 
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Macintosh Programming Techniques 

More Mac Programming Techniques 

Network Frontiers Bundle 

Newton Programming Guide 

Object Oriented Programming Design 

Optimizing PowerPC Code 

PostScript Language Reference 

Power Macintosh Programming Starter Kit 
PowerPC Programmer's Toolkit 

Programing Introduction to the Macintosh Family 
Programming for System 7 

Programming Primer Macintosh Volume 1 
Programming QuickDraw 

Programming Starter Kit 

Programming with AppleTalk 

QuickTime - Official Guide for Macintosh Users 
QuickTime Starter Kit for the Macintosh 

Real World Apple Guide 

ResEdit All Night Diner 

ResEdit Complete, 1st Edition 

ResEdit Complete, 2nd Edition 

ResEdit Reference 

software by Design: Creating User Friendly Software 
Teach Yourself Macintosh C++ in 21 Days 

Tog on Software Design 

Wireless for the Newton Development for Mobil Comm. 
Writing Localizable Software 


Miscellaneous 


Adobe Premiere for the Macintosh 
America Online for Dummies 

Art of Human Interface Design 

Best of MacTutor 3, 4, 5 

CD-ROM Guide to Multimedia Authoring 
CompuServe for Dummies 

Creating Interactive CD-ROM 
Cyberpunk Handbook 

Danny Goodman’s Macintosh Handbook 
eWorld: The Essential Guide 
FrameWorks Source Code Disk 
FrameWorks Magazine Back Issue 
Global Interface Design 

Graphic Gems 2 

Graphic Gems 4 

Graphic Gems V 

Infini-D Revealed 

Late Night with MacHack 

Mac Bathroom Reader 


Mac Screamer: The Ultimate Macintosh Supercharging Kit 


Macintosh Crash Course 

MacTech Back Issues 

Macworld Ultimate Macintosh Book 
Managing AppleShare & Workgroup Servers 
MADACON ‘93 CD-ROM 


Multimedia Authoring: Building and Developing Documents 


Multimedia Starter Kit for Macintosh 
Profit from Experience 

sad Macs, Bombs and Disasters 
Sex, Lies & Video Games 

Stupid Mac Tricks 

Tricks of the Mac Game Gurus 


BPTECH 
BMORETECH 
BNETFB 
BNEWTPGUID 
BOOPRODES 
BOPTPPC 
BPSLANREF 
BPPCSTART 
BPPCPT 
BFAMILY 
BSYS/ 
BPRIMMAC 
BPROQDRAW 
BPROSTART 
BPROAT 
BQTGUIDE 
BQTSKIT 
BREALWLD 
BRESDINE 
BRESED1 
BRESED2 
BRESEDREF 
BDESIGN 
BCPP21D 
BIOG 
BWIRELESS 
BLOCAL 


BPREM 
BAOLDUM 
BAHID 
BMTBEST 
BCDMULT| 
BCSDUM 
BINTERCDR 
BCYBPUNK 
BGOODHB 
BEWORLD 
MTFWSC 
MTFWBACK 
BGLOBAL 
BGEMS2 
BGEMS4 
BGEMS5 
BINFDREV 
BLATE 
BBATH 
BSCREAM 
BCRASH 
MTBACKISS 
BULTMAC 
BMAWS 
SMADAY3 
BMMAUTH 
BMMSTART 
BPROHT 
BSADMAC 
BSEX 
BSTUPIDMAC 
BIRICKS 


$34.95 
$39.95 
$89.95 
$44.95 
$22.95 
$39.95 
$32.95 
$39.95 
$45.00 
$24.95 
$26.95 
$37.95 
$26.95 
$45.00 
$24.95 
$49.50 
$45.00 
$39.95 
$24.95 
$34.95 
$34.95 
$29.95 
$29.95 
$29.99 
$29.95 
$34.95 
$26.95 


$49.95 
$19.95 
$32.95 
$99.00 
$44.95 
$19.95 
$39.95 
$9.95 

$29.95 
$29.95 
$9.95 

$10.00 
$34.95 
$49.95 
$49.95 
$49.95 
$45.00 
$29.95 
$12.99 
$35.00 
$29.95 
$10.00 
$39.95 
$29.95 
$95.00 
$34.95 
$30.00 
$24.99 
$24.95 
$34.95 
$19.95 
$50.00 


$31.95 
$34.50 
$59.95 
$40.46 
$20.66 
$35.96 
$29.66 
$35.10 
$40.50 
$22.46 
$24.25 
$34.15 
$24.25 
$40.50 
$22.45 
$45.00 
$40.50 
$35.95 
$22.45 
$31.45 
$31.45 
$26.96 
$26.95 
$26.99 
$26.95 
$31.45 
$24.25 


$44.95 
$17.95 
$29.65 
$9.95 

$40.45 
$17.95 
$35.95 
$8.95 

$26.95 
$9.95 

$9.95 

$8.00 

$32.35 
$44.95 
$44.95 
$44.95 
$40.50 
$26.95 
$11.70 
$31.50 
$26.95 
$5.00 

$35.95 
$26.95 
$9.95 

$31.45 
$27.00 
$22.45 
$22.45 
$31.46 
$17.95 
$45.00 
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All entries in this index are alphabetized. 


For your convenience the product names are bold, book names are italicized and company 


names are in plain text. 


8D Graphics Programming Using QuickDraw 3D.......... Ze 
eae en eey . Cee ee eee 
A Fragment Of YOU IM@QINAtION. .eceecccceectseeteceeeteene 19 
PISO cotastmumaunsassuisinndtventvatuatednssnicvecasetamcayweseucicosneecieeset 4 
PGI NG cectiiciaasoaieinentteeatvamssaupietestonte eaetsieeancetasececorens 10 
Advanced Color Imaging on the Mac OS... 23 
Apple Computer, INC. voce ccecesessecessceteseceeecseesereeeeenees 14 
ADPIOGUIA® COMPICIC 0. cecsccccsssetcstsstscctssessseesstsestsenees 26 
AppleScript Applications: Building Applications with 
FOO I rates crcsestunsasecaenacuactiadens tum cnseasminscna tess 26 
AppleScript Finder Guide, English Dial@Ct...ccccccccccee 20 
AppleScript Language GUIDG ....ccccccececcscsccecseeeee 20 
AppleScript Scripting ACItiONS GUIDE ....ccccceccceee eee. 20 
ADDICO IMEC SCHOUNG wesnevetvrinienssusiidtatlenivrumevartnin 20 
PRIN ANGON ca ieciaticasicacsavevsaavcastenssonscnucnisnsuzesceciseasioenses: 12 
ee - ee 
Bo rege Bar ars aau pon nersasinetec cca secuewetcnenecteeteiuctis 12 
Bare Bones Software .....cccscsscssssssssssssssseseesssesseeves 8, 11 
BASIC for the N@WION visccccccccecssctsccscecssectsssseseseseseess 26 
BG va ceevias tancensvaiensiistensnivinessastiuasleusessieuecduivoaaies 8 
BICST OF IMAC UL OF sciscinncencessintsnttvitncnsmnstedntitasaniidaneianedasiees 2 
Black Art of Macintosh Game PrograMmMiIng ....:cceee Ved 
Bowers DeveloOMent......ccccccccssccccscssseccssessseesssserees iz 
C++ Programming with COGQWAMTION .....cccccccteeeeeeee 24 
C++ Programming With MACAOD.iieseccccssetereeseeneee 24 
CHGS aC acti tyinetaneseusaperisvnddtrenesessnseeiienet i7 
COCA AST sas icsesincesevtpivenesstdccsncdecessaseneaeavnatanusnenne 9 
CodeWarrior 10 Gold.........scsssssssscssessessessesseessessessees 3 
CodeWarrior Software Development Using PowerPlant1 7 
CodeWarrior Wea .......:sscssscesscesssessesseeeseeesseenseesseesenens 3 
CPU DOUDIER siicctsicctinnacsarstansynnyucutiastvatiaiaiaiciigctiisinancni 9 
FORMAN AGEN sessississanvessicatiinetsnsassausavsnsnavsenndeusancseresiwunas 9 
Cyberdog PrOGraMMers Kit ...cccceccessssscsecsssetssessseesees 19 
es ee 
Dan Shafer Presents the Power of Prograph CPX.......25 
Danny Goodman's AppleScript HandbO0k.....ccccccceees 20 
Danny Goodman's Apple Guide Starter Kit ..cccccccccce ZO 
DeBabelizer: The Authorize EQution vi.teccectccesecerseeesen 21 
Designing Animation for th WED ...cccccscctscsteseseeetseens 17 
Discover Programming for Macintosh .........:::ss00 3 
a ees » eee 
(OUI ‘ss cunsupsatdneaaceusucsuleauacioaveaueesiusueadusviuideunanivedtvesivitebiiests 11 
Duet DeVElOPMENt ...... cc ceccsecesssssssssessssssenseseesseesereveats 9 
See eee (ee, 
Bee ia! COC IOC: mcieriscseuunmracetieonmnanvnntin 24 


FACCS DAN V2.1 ssccccccsneneccainnccaccussiussnnateavaneveavsiuevavenucawiuees 7 
File Genie Pro .......ccscsessscessscesssseceesesscenseseesensneesenseeenenes 9 
Fortner RESCQrCh .......ceceeseeeseceesscececeeeseeenneeeeeeentnnneeeeeess 11 
Fortran 77SDK......sssscscssssssscsssssscsccssesecsesscnsccsenccssessecesses 4 
ae Eee eee eee 
OV oi sresteireastectaceionnioneniat evvmaphanpanieanis 23 
GUarANTEE TNMNS...cc cc ccccccecsecccsssescssssescsssesesueecerueesensas | 
Guide Composer 1.2......csssssssssssstesssesssessseesseeesseeeeees 9 
ae ees | Eee 
HOOKEC” ON SQV iiicccccccccscccsccssscccccssseeseecsssseeestseeeeecsssess 15 
ees eee | Gee eee 
NG sisesrtehatek teeta san ecsasecai nnadiataeteesiiateeantetabernes 11 
FOROPLD FEV COICO sie isscrsciecsttsuaitensagtonibeesasaocecuersenretsbenntontts 19 
WISIDG: GOCE WVAMON 9 ccesccccanossseuscnteecseesceteisesennnsiuntencants 24 
Inside Macintosh: AOCE Applications Interface..........+. 14 
Inside Macintosh: AOCE Servic@ MOdUIe ....cccccccceeeeee 14 
Inside Macintosh: CD-ROM ......csssssssssssscessssseeeees 14 
Inside MacintOSh: DEVICES wiicecccccccccscecteccsecsertseseeseees 14 
INSICGG MACINtOSN: FICS voccccccccccccceccsssccsecssssscesstsseseeesaeees 14 
Inside Macintosh: Imaging with QUICKDIAW uu... 14 
Inside Macintosh: Interapplication Communications.....14 
Inside Macintosh: Macintosh Toolbox Essentials .......... 14 
INSIDE MACINCOSA: MEMOS. issescscctsestesertesesseetsseetssentesens 14 
Inside Macintosh: More Macintosh TOOIDOX ....ccccccceee 14 
Inside Macintosh: N@twWOrkinQ..scccccscscsetesesersien 14 
Inside Macintosh: Operating System UtilitieS .....cce. 14 
INsIAe MaCintOSh: QVEIVICW visccsccccssscccecesssecessssseeseenssaees 14 
Inside Macintosh: PowerPC NUMETICS wiccccccseseeesseees 14 
Inside Macintosh: PowerPC System Somware .......60 14 
Inside MacintOSh: PrOCESSES wivccccccccscecssssesseesesstseseesnees 14 
Inside Macintosh: QuickDraw GX Environ. & Util, wc 14 
Inside Macintosh: QuickDraw GX GIajOhliCS vo... 14 
Inside Macintosh: QuickDraw GX ODJOCEHS vss 14 
Inside Macintosh: QuickDraw GX Printing Extension....14 
Inside Macintosh: QuickDraw GX PLINTING wees 14 
Inside Macintosh: QuickDraw GX Prog. Overview.......- 14 
Inside Macintosh: QuickDraw GX TyPOgraphy......c. 14 
Inside Macintosh: QuickTiMe COMPONENTS ....ceeeee 14 
INsIDe MaCintOSh: QUICKTIING vicccccccccccceectssecestseeeessnssees 14 
INSIDE MiACINIOSI SOUNG senissssincoveceresanncetavernentearnicceins 14 
WISIOS VIGCHMNOSI: [OX sccasincstscctonisucerinlavsadsaerssitesesnmenis 14 
Inside Macintosh: X-REPCPCNCE w.ccccccccccccctssseetstseseeesnsees 14 
Inside PowerPlant MQNual.wicciccccccccccccccccccsecsseeesssseeeees 23 
Internet Publishing with Adobe ACrobat.....ccccccseceen yas 
Intranet Web D@VEIODMENE u...ccccccetcseesssecesseseestseseessees ve | 
SAVE TAG INOISISI caciieisococnuetRencpintyasavennenenpisinesiddeeadeirenss ite) 
Java Language API SuperBible .....cccccccccccsseeeesteeserenes 19 
JavaScript for the MACINCOSN wicciccccccccsccscessssssessttseeseeens 16 


Web site: htto://www.devdepot.com ® E-mail: orders@devdepot.com 
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Late Night Software Ltd......... 
Learn C on The Macintosh Second Ealtion. 
Learn C++ on the Macintosh....... 
Learn HTML on the Mac... 
Learn JaVa ON TNE MGC vieiiecccccccccccststeeseeecsssesssseeeseses 
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Mac OS 8 Revealed... 
Macintosh C Programming Primer Volume I........0006+ 
Macintosh C Programming Primer Volume Il.........+. 
Macintosh Pascal Programming Primer Volume |.........18 
Macintosh PrograMMiIng SECIets wits 18 
MacsBug Reference & DEDUQGGING GUIDE .......:ccceeee 20 
MacTech Back Issues ..... 
MacTech CD-ROM Volumes 1-11.. 
MacTech Magazine.......... 
MacTech Mouse Pad........ssssssscssssssssesssssssessssessseees 
Main Event SOfRWANE .....ccccccccsccescssseecesssseeeessseeeeeeseeees 
Mastering Netscape 4.0 for MACINtOSN Low... 
Mastering the THINK Class Library......00++. 
Memory Mine..... 
Metrowerks CodeWarnor Programming .. 
Metrowerks uu... 
Mjolner BETA Systeim..........:csssssssssssessssssssssesseesseeee 
Movie Cleaner Pro 1.2......sssssssssscsssesessserssseeesssessseeesO 



























































Natural Intelligence... 
NeoAccess.......... 
PIS OIOGIC saaicrin nacnsnttncoupinad vena tensa geen evai ollaueatarignaanpnantevcan 1c 
NetObjects FUSION HANQDOOK,...cccccssccsseseesesereerseeee 1G 
Netscape Navigator Starter Kit for Macintosh .........0...26 
Network Frontiers BUNOIE ....cccectscettssesteseessectsesertesee Ol 
Nisus Software... 
NS BASIC 3.5 for the Newton ....... 
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Get JAM and enjoy success in building 
and deploying client/server and Web applications 
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In a world where requirements change and deadlines don’t, only JAM gives you what 

you need to build powerful, completely portable client/server, 3-tier and Web applications. 
JAM’s cross-platform RAD capabilities enable you to successfully develop and deploy 
demanding applications across any platform, database, GUI or Web Browger. 


Are you willing to base your project's success on a tool that only promises portability? 
JAM lets you build great looking applications that are fully portable today. If you need to 
build serious client/server, 3-tier or Web applications, call JYACC for a free demonstration 
kit or white paper. 


Desktop ease with the power of a 2nd-generation tool 

Unrivaled portability between Windows® 3.1, NT, 95; Macintosh®; OS/2 Warp"; 
Character, Motif and Web Browsers 

Unparalleled database access to Oracle®, Sybase®, Informix®, ODBC and more 
Automatic SQL generation with full transaction control 

Visual repository-driven development of both client and application server 
Centralized control over application objects via inheritance 

Unique architecture for team development 

No runtimes 


~~ Se 


Find out for yourself how sweet life can be with JAM! 


Call 1 800 458-3313. 


Or E-mail: sweetlifeS@jyacc.com for a free demonstration kit or white paper. 
Visit our Web site at http://www.jyacc.com 
For international inquiries call: 1-212-267-7722 or FAX 1-212-608-6753 


JAM is a registered trademark of JYACC, Inc. Other trademarks are the property of their respective owners. 
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For More Information Call 1-800-377-5416 


System requirements: Macintosh 68020, 68030 or 68040, or Power Macintosh 601, 603 or 604 processor. Minimum of 8 MB RAM, 16 MB recommended, 
CD-ROM drive to install software. ©1996 Metrowerks Corporation. All rights reserved. All products are trademarks of their respective companies. 
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